Se você já ouviu falar em monorepos, mas ainda não sabe por onde começar ou quais são suas vantagens, este guia foi feito para você. Vamos explorar de maneira simples e prática o que é um monorepo, como ele se diferencia de outras abordagens e como configurar um usando Yarn Workspaces.
O que é um Monorepo?
Um monorepo é um único repositório que armazena múltiplos projetos distintos, que podem ser utilizados de forma independente ou combinados em aplicações maiores.
A principal vantagem é que o código está disponível em um só lugar na sua versão mais atualizada.
Monorepos vs. Polyrepos
A abordagem “polyrepo” é a mais comum no desenvolvimento de software: cada projeto tem seu próprio repositório. Isso pode ser funcional, mas nem sempre eficiente.
No monorepo, por outro lado, o acesso ao código é instantâneo e unificado, permitindo maior colaboração e reutilização entre projetos.
Monorepos não são Monolitos
É importante destacar que monorepos não são sinônimos de monolitos.
- Monorepo: Projetos separados, mas organizados em um único repositório. Temos pacotes completamente isolados uns dos outros.
- Monolito: Um monolito é um grupo de projetos que compoem um grande projeto.
Configurando Yarn Workspaces em um Monorepo
Primeiro, inicialize seu projeto com Yarn:
yarn init -y
Em seguida, configure o package.json para suportar Yarn Workspaces:
{
"private": true,
"workspaces": ["packages/*"]
}
Nota: A propriedade private: true é obrigatória. Isso garante que o monorepo não será publicado acidentalmente como um pacote público.
Criando pacotes no Monorepo
Dentro do diretório do projeto, crie uma pasta chamada packages para armazenar seus pacotes:
mkdir packages
mkdir packages/package-01
mkdir packages/package-02
Crie um arquivo package.json dentro da pasta de cada pacote, você pode fazer isso usando o seguinte comando:
yarn init -y
Volte para o diretório root e instale as dependências:
yarn install
Observe que o monorepo terá apenas um arquivo yarn.lock, centralizando a gestão de dependências.
Gerenciando Pacotes no Monorepo com Yarn
Para rodar um comando em um pacote específico, use:
yarn workspace package-01 start
Precisa rodar um comando em todos os pacotes do monorepo? Simples:
yarn workspaces run start
Instalando Dependências
Para adicionar uma dependência em um pacote específico:
yarn workspace package-01 add react
Para adicionar uma dependência ao root do monorepo:
yarn add lodash -W
Usando Pacotes Internos do Monorepo
Para utilizar um pacote dentro de outro, instale a mesma versão especificada no package.json:
yarn workspace package-01 add package-02 --peer
Isso criará um link automático no monorepo, facilitando a integração.
Conclusão
Monorepos oferecem colaboração eficiente, gestão centralizada de dependências e maior produtividade para equipes que trabalham em múltiplos projetos. Com Yarn Workspaces, configurar e gerenciar um monorepo se torna uma tarefa simples e escalável.
Agora que você conhece os fundamentos, está pronto para começar a utilizar essa poderosa abordagem em seus projetos!