Monorepositório com JavaScript: organização de código na prática

Monorepositório com JavaScript: organização de código na prática

O desenvolvimento de projetos complexos em JavaScript (Node.js) frequentemente enfrenta o problema de gerenciamento de código. Quando você tem vários pacotes, bibliotecas ou microsserviços, cada um vivendo em seu próprio repositório, isso leva à duplicação de código, dificuldade de sincronização de versões e lentidão no CI/CD. A solução é o monorepositório (monorepo). Neste artigo, vamos analisar como organizar um monorepositório com JavaScript na prática: desde a escolha das ferramentas até a configuração da build e publicação.

O que é um monorepositório e por que ele é necessário?

Monorepositório é uma abordagem para gerenciamento de código onde todos os pacotes, bibliotecas e aplicações do projeto são armazenados em um único repositório. Ao contrário dos multirrepositórios (cada pacote em seu próprio repo), o monorepositório oferece:

\n
• Histórico único de alterações: fácil rastrear como mudanças em uma parte afetam outra.
\n
• Reutilização de código: utilitários e componentes comuns vivem em um só lugar sem necessidade de publicação no npm.
\n
• Refatoração simplificada: a alteração da API de um pacote é imediatamente visível em todos os dependentes.
\n
• Configurações unificadas de CI/CD: um único arquivo de configuração para todos os pacotes.
\n

Para JavaScript (Node.js), o monorepositório é especialmente relevante, pois permite eliminar o "inferno das dependências" e acelerar o desenvolvimento. Vamos considerar a implementação prática.

Ferramentas para monorepositório em JavaScript

Existem várias ferramentas populares no mercado. Vamos considerar duas principais: npm workspaces (integrado ao npm) e Lerna (funcionalidade estendida).

1. npm workspaces (suporte nativo)

A partir do npm v7, o gerenciador de pacotes suporta workspaces. Esta é a maneira mais simples de começar. Exemplo de estrutura de projeto:

my-monorepo/\n├── packages/\n│   ├── core/\n│   │   ├── package.json\n│   │   └── index.js\n│   ├── utils/\n│   │   ├── package.json\n│   │   └── helpers.js\n│   └── app/\n│       ├── package.json\n│       └── server.js\n├── package.json\n└── lerna.json (opcional)

package.json raiz:

{\n  "name": "my-monorepo",\n  "private": true,\n  "workspaces": ["packages/*"]\n}

Agora todos os pacotes em packages/* são automaticamente vinculados. Para instalar as dependências, basta executar npm install na raiz. As dependências entre pacotes são especificadas de forma padrão:

// packages/app/package.json\n{\n  "name": "@my/app",\n  "dependencies": {\n    "@my/core": "*",\n    "@my/utils": "*"\n  }\n}

O npm workspaces cria symlinks na pasta node_modules, portanto, os imports funcionam como com pacotes comuns.

2. Lerna (gerenciamento avançado)

Lerna é uma ferramenta para gerenciar monorepositórios com capacidade de publicação, versionamento e execução de scripts em paralelo. Instalação:

npm install --global lerna

Inicialização no projeto:

lerna init

Arquivo lerna.json:

{\n  "version": "independent",\n  "npmClient": "npm",\n  "packages": ["packages/*"]\n}

O modo independent permite que cada pacote tenha sua própria versão. Comandos principais:

\n
• lerna bootstrap — instala dependências e vincula pacotes.
\n
• lerna run build — executa o script build em todos os pacotes.
\n
• lerna publish — publica pacotes alterados no npm.
\n

Organização prática do código

Vamos considerar um exemplo de configuração de monorepositório para uma aplicação web com backend em Node.js e utilitários comuns.

Passo 1: Estrutura básica

Vamos criar três pacotes:

Blogs

JavaScriptSerializer e enum para string: principais erros e como evitá-los

Book Recommendations

TypeScript: dicas e melhores práticas

Desenvolvimento de API em TypeScript: do zero à produção

Server-Side Development with Kotlin and Spring Boot

Hands-on Kotlin Coroutines for Android: Guia prático de Corrotinas Kotlin para Android

Leia também

Arrays em Java: como declarar e inicializar? Guia completo Implantação zero-downtime de serviços Kotlin: 3 estratégias comprovadas Rust como cola universal: Integração com Python, C e outras linguagens Depuração e execução de C#: VPS, Docker ou Cloud — qual escolher? GraphQL API com Swift: tutorial prático passo a passo