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.