1~
2Quando si lavora su progetti software di una certa complessità, la scelta tra monorepo e polyrepo può avere un impatto significativo sulla produttività del team e sulla scalabilità del codice. In questo articolo analizziamo le differenze, i pro e i contro di ciascun approccio, e ti aiutiamo a capire quale fa al caso tuo.
3~
4## Cosa sono Monorepo e Polyrepo?
5~
6### Monorepo
7~
8Un **monorepo** (monolithic repository) è un singolo repository che contiene il codice sorgente di più progetti, servizi o pacchetti, spesso correlati tra loro.
9~
10```plaintext filename="Esempio struttura Monorepo"
11my-monorepo/
12  packages/
13    frontend/
14    backend/
15    shared/
16  package.json
17  turbo.json
18```
19~
20### Polyrepo
21~
22Un **polyrepo** (multiple repositories) prevede che ogni progetto, servizio o pacchetto abbia il proprio repository separato.
23~
24```plaintext filename="Esempio struttura Polyrepo"
25repos/
26  frontend/
27    package.json
28  backend/
29    package.json
30  shared/
31    package.json
32```
33~
34## Differenza visiva
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## Pro e Contro
57~
58### Monorepo
59~
60**Vantaggi:**
61- Facilita la condivisione di codice (es. librerie condivise).
62- Refactoring atomico su più progetti.
63- Gestione centralizzata delle dipendenze e delle configurazioni.
64~
65**Svantaggi:**
66- Può diventare pesante con la crescita del codice.
67- Richiede strumenti per gestire build/test parziali (es. Nx, Turborepo).
68~
69### Polyrepo
70~
71**Vantaggi:**
72- Ogni team/progetto è indipendente.
73- Più semplice da gestire per piccoli progetti.
74- Permette policy di accesso granulari.
75~
76**Svantaggi:**
77- Difficile condividere codice senza pubblicare pacchetti.
78- Refactoring cross-repo più complesso.
79- Possibile duplicazione di configurazioni.
80~
81## Esempio pratico: Monorepo con Turborepo
82~
83Supponiamo di voler creare un monorepo con frontend e backend usando Turborepo.
84~
85### 1. Inizializza il monorepo
86~
87```bash
88npx create-turbo@latest
89```
90~
91### 2. Struttura tipica
92~
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # libreria di componenti condivisi
100    utils/      # funzioni condivise
101  turbo.json
102  package.json
103```
104~
105### 3. Esempio di workspace in `package.json`
106~
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116~
117### 4. Esempio di importazione di una libreria condivisa
118~
119Supponiamo di avere una funzione in `packages/utils/src/formatDate.ts`:
120~
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('it-IT');
125}
126```
127~
128Nel frontend:
129~
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133~
134export default function Home() {
135  return <div>Oggi è {formatDate(new Date())}</div>;
136}
137```
138~
139## Quando scegliere Monorepo?
140~
141- Team medio-grandi che lavorano su più progetti correlati.
142- Necessità di condividere codice e fare refactoring su larga scala.
143- Progetti che crescono velocemente e richiedono build/test ottimizzati.
144~
145## Quando scegliere Polyrepo?
146~
147- Progetti piccoli o indipendenti.
148- Team separati che lavorano su prodotti diversi.
149- Policy di accesso molto restrittive.
150~
151## Conclusione
152~
153Non esiste una soluzione perfetta per tutti. La scelta dipende dalla dimensione del team, dalla complessità dei progetti e dalle esigenze di collaborazione. L’importante è essere consapevoli dei trade-off e scegliere gli strumenti giusti per gestire la complessità.
154~