1 
2Ao trabalhar em projetos de software complexos, a escolha entre monorepo e polyrepo pode impactar significativamente a produtividade da sua equipe e a escalabilidade do código. Neste artigo, analisamos as diferenças, prós e contras de cada abordagem, e ajudamos você a entender qual é a certa para você.
3 
4## O que são Monorepo e Polyrepo?
5 
6### Monorepo
7 
8Um **monorepo** (repositório monolítico) é um único repositório que contém o código-fonte de múltiplos projetos, serviços ou pacotes, frequentemente relacionados entre si.
9 
10```plaintext filename="Example Monorepo Structure"
11my-monorepo/
12  packages/
13    frontend/
14    backend/
15    shared/
16  package.json
17  turbo.json
18```
19 
20### Polyrepo
21 
22Um **polyrepo** (múltiplos repositórios) significa que cada projeto, serviço ou pacote tem seu próprio repositório separado.
23 
24```plaintext filename="Example Polyrepo Structure"
25repos/
26  frontend/
27    package.json
28  backend/
29    package.json
30  shared/
31    package.json
32```
33 
34## Diferença Visual
35 
36```mermaid
37flowchart TD
38    subgraph Monorepo
39        A1["frontend/"]
40        A2["backend/"]
41        A3["shared/"]
42    end
43    style Monorepo fill:#e0e7ff,stroke:#6366f1,stroke-width:2px
44```
45 
46```mermaid
47flowchart TD
48    subgraph Polyrepo
49        B1["frontend repo"]
50        B2["backend repo"]
51        B3["shared repo"]
52    end
53    style Polyrepo fill:#fee2e2,stroke:#ef4444,stroke-width:2px
54```
55 
56## Prós e Contras
57 
58### Monorepo
59 
60**Vantagens:**
61- Facilita o compartilhamento de código (ex.: bibliotecas compartilhadas).
62- Refatoração atômica em múltiplos projetos.
63- Gerenciamento centralizado de dependências e configurações.
64 
65**Desvantagens:**
66- Pode ficar pesado conforme a base de código cresce.
67- Requer ferramentas para gerenciar builds/testes parciais (ex.: Nx, Turborepo).
68 
69### Polyrepo
70 
71**Vantagens:**
72- Cada equipe/projeto é independente.
73- Mais fácil de gerenciar para projetos pequenos.
74- Permite políticas de acesso granulares.
75 
76**Desvantagens:**
77- Mais difícil compartilhar código sem publicar pacotes.
78- Refatoração entre repositórios é mais complexa.
79- Possível duplicação de configurações.
80 
81## Exemplo Prático: Monorepo com Turborepo
82 
83Suponha que você queira criar um monorepo com frontend e backend usando Turborepo.
84 
85### 1. Inicializar o monorepo
86 
87```bash
88npx create-turbo@latest
89```
90 
91### 2. Estrutura típica
92 
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # shared component library
100    utils/      # shared functions
101  turbo.json
102  package.json
103```
104 
105### 3. Exemplo de workspace em `package.json`
106 
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116 
117### 4. Exemplo de importação de biblioteca compartilhada
118 
119Suponha que você tenha uma função em `packages/utils/src/formatDate.ts`:
120 
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('en-US');
125}
126```
127 
128No frontend:
129 
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133 
134export default function Home() {
135  return <div>Today is {formatDate(new Date())}</div>;
136}
137```
138 
139## Quando Escolher Monorepo?
140 
141- Equipes médias-grandes trabalhando em múltiplos projetos relacionados.
142- Necessidade de compartilhar código e realizar refatorações em larga escala.
143- Projetos que crescem rapidamente e requerem builds/testes otimizados.
144 
145## Quando Escolher Polyrepo?
146 
147- Projetos pequenos ou independentes.
148- Equipes separadas trabalhando em produtos diferentes.
149- Políticas de acesso muito restritivas.
150 
151## Conclusão
152 
153Não existe uma solução perfeita para todos. A escolha depende do tamanho da equipe, da complexidade do projeto e das necessidades de colaboração. O importante é estar ciente das compensações e escolher as ferramentas certas para gerenciar a complexidade.
154