Strategie Monorepo per Sviluppo Web

Strategie Monorepo per Sviluppo Web

Un monorepo memorizza più progetti (app, librerie) in un singolo repository. Vantaggi: Condivisione codici, commit atomici, gestione dipendenze semplificata, tooling unificato.

Perché Monorepo?

Codice condiviso: Tipi, utility, componenti UI, config. Cambiamenti atomici: Refactor cross-project in una PR. Singola pipeline CI: Tooling consistente. Aggiornamento dipendenze facile: Una policy versione. Collocazione: Codice correlato sta insieme. Usato da: Google, Meta, Microsoft, Vercel, Shopify.

Confronto Tool

Nx: Computation caching, distributed task execution, affected graph, plugin per React, Next.js, Node, Go, .NET. Turborepo: Smart caching, remote caching (Vercel), task pipeline, config minimo. pnpm workspaces: Nativo, veloce, disk-efficient, niente tool extra. Yarn workspaces: Maturo, plug'n'play. Lerna: Legacy, ora usa Nx sotto il cofano. Bazel: Ermetico, complesso, per scala massiccia.

Struttura Pacchetti

apps/: Applicazioni deployabili (web, mobile, api, docs). packages/ o libs/: Librerie condivise (ui, utils, config, tsconfig, eslint-config). tools/: Script build, generatori, tooling custom. Ogni package: package.json, tsconfig.json, propri test.

Gestione Dipendenze

Dep interne: workspace:* protocol (pnpm), file: protocol. Policy versione: Fixed (tutte uguali), Independent (ciascuna propria), Locked (sync al release). Dipendenze condivise: Hoisted a root node_modules (pnpm/yarn). Peer deps: Per plugin (React, Next.js).

Build Incrementali

Affected graph: Build/test solo ciò che è cambiato. Nx: nx affected --target=build. Turborepo: turbo run build --filter=...[origin/main]. Hash-based caching: Input (sorgente, config, env) → hash → cache hit/miss. Remote cache: Condividi across team/CI (Nx Cloud, Vercel Remote Cache).

Pattern Condivisione Codice

Tipi condivisi: Interfacce TypeScript in package condiviso. UI condivisa: Component library (Storybook, Chromatic). Config condivisa: ESLint, Prettier, TypeScript, Tailwind preset. Utility condivise: Formattazione date, validazione, costanti. Client API: Generati da OpenAPI/GraphQL.

CI/CD in Monorepo

Affected detection: Solo test/build progetti cambiati. Esecuzione parallela: Distribuisci across agenti. Caching: Ripristina da remote cache. Deployment: Deploy solo app affected. Preview deployment: Ambienti per-PR (Vercel, Netlify, Cloudflare Pages).

Generatori e Automazione

Nx generators: Scaffold app, libs, componenti, aggiorna config. Generatori custom: Enforza standard org. Migrazioni automatizzate: Aggiorna dipendenze, codemods. Release: Changesets, Nx release, semantic-release. Version bump: Independent o fixed.

Sfide e Soluzioni

Clone grande: Shallow clone, sparse checkout (Git 2.38+). IDE lento: Escludi node_modules, usa project references (TypeScript). Rischio coupling: Enforza boundary (Nx tags, eslint-plugin-boundaries). Merge conflict: Trunk-based development, PR piccole. Complessità tooling: Inizia semplice, adotta incrementalmente.