Pular para o conteúdo
Criação de Apps

Monorepo ou vários repositórios: como escolher para o seu projeto

Resposta rápida

Monorepo guarda vários projetos em um único repositório; a alternativa é um repositório por projeto. Monorepo facilita mudanças que atravessam partes do sistema. Vários repositórios dão mais independência entre equipes e deploys.

Neste artigo
  1. O que é cada modelo
  2. Quando o monorepo ajuda
  3. Onde o monorepo pesa
  4. Quando separar em vários repositórios
  5. Como decidir

Quando um app cresce e passa a ter site, API, aplicativo móvel e bibliotecas comuns, surge a pergunta: guardar tudo no mesmo repositório Git ou separar? As duas escolhas funcionam. O que muda são os custos de cada uma.

O que é cada modelo

No monorepo, vários projetos vivem em um repositório só, em pastas separadas. No modelo de vários repositórios, também chamado de multirepo, cada projeto tem seu próprio repositório, histórico e permissões.

Se você ainda está se familiarizando com o controle de versão, vale começar pelo guia de Git e GitHub para iniciantes.

Quando o monorepo ajuda

  • Uma mudança precisa alterar a API e o front-end ao mesmo tempo. Num só repositório, isso vira um único conjunto de alterações, revisado de uma vez.
  • Há código compartilhado, como tipos, validações ou componentes visuais, usado por várias partes.
  • A equipe quer padronizar ferramentas, regras de formatação e testes.
  • Você quer enxergar todo o sistema em um lugar só.

Onde o monorepo pesa

  • Repositórios grandes ficam lentos para baixar e para rodar testes se não houver ferramentas que executem apenas o que mudou.
  • Controle de acesso é mais grosseiro: quem entra no repositório tende a ver tudo.
  • Pipelines de build e deploy exigem mais cuidado para publicar só a parte alterada.
  • Em geral é preciso adotar ferramentas de gerenciamento específicas para manter a organização.

Quando separar em vários repositórios

  • Equipes diferentes cuidam de partes diferentes, com ritmos próprios de entrega.
  • Os projetos têm ciclos de vida independentes, como uma biblioteca pública e um app interno.
  • É necessário restringir quem acessa cada parte do código.
  • Cada serviço é publicado e versionado separadamente.

A contrapartida é o trabalho de manter bibliotecas compartilhadas em sincronia: uma correção em um repositório precisa ser publicada e atualizada nos outros.

Como decidir

Pergunte-se quatro coisas:

  • Quantas pessoas mexem no código?
  • As partes costumam mudar juntas?
  • Há código compartilhado que muda com frequência?
  • Existe necessidade de isolar acessos?

Para uma pessoa ou equipe pequena com poucas partes que mudam juntas, um repositório só costuma ser mais simples. Se as partes são independentes, separar tende a dar menos atrito. Mudar depois é possível, mas dá trabalho, especialmente para preservar o histórico, então vale decidir com alguma calma no começo. E, seja qual for o modelo, nunca suba senhas ou chaves; veja o que fazer no caso de uma chave de API vazada no GitHub.

  • Git
  • Arquitetura
  • Desenvolvimento

Perguntas frequentes

Monorepo é o mesmo que monólito?

Não. Monorepo é como o código é guardado; monólito é como o sistema é construído. Um monorepo pode conter vários serviços independentes.

Projeto pequeno precisa de monorepo?

Normalmente não. Com poucas partes, um repositório simples, ou até um por parte, funciona bem sem ferramentas extras.

Leia também

Criação de Apps

Git e GitHub para iniciantes: o que são e como usar

O que cada um faz, os comandos essenciais e o fluxo mais simples para guardar o histórico dos seus códigos.

· 5 min de leitura
Criação de Apps

Subi uma chave de API ou senha no GitHub: o que fazer agora

O passo a passo de emergência para quem publicou um segredo por engano num repositório.

· 5 min de leitura
Criação de Apps

Monolito ou microsserviços: qual arquitetura escolher no seu app

Dividir o sistema em muitos serviços resolve alguns problemas e cria outros.

· 2 min de leitura
Criação de Apps

Code review: como revisar código com pull request sem atrasar o time

Revisar código em pull request é menos sobre achar culpados e mais sobre evitar erros antes de publicar.

· 3 min de leitura

Deixe seu comentário