pnpm Workspaces per i monorepo

pnpm (Performant npm) è un gestore di pacchetti veloce ed efficiente in termini di spazio su disco. Memorizza una sola copia di ogni pacchetto in uno store globale content-addressable e crea collegamenti a essa dai node_modules del progetto. Stessa dipendenza, più progetti = una sola copia su disco.

In un monorepo tipico, le installazioni di pnpm sono da 2 a 3 volte più veloci di quelle di npm/yarn e utilizzano circa il 70% in meno di spazio su disco. I vantaggi sono enormi nei monorepo con molti pacchetti.

Utilizzi Corepack (incluso in Node 16+) oppure lo installi globalmente.

Crei un pnpm-workspace.yaml nella root, elencando le cartelle che contengono i pacchetti.

Ogni app e pacchetto ha il proprio package.json. La root ha un package.json del workspace con le devDeps condivise.

Esegua pnpm install una sola volta nella root. pnpm installa tutto in tutti i pacchetti, portando al livello superiore le dipendenze comuni.

Faccia riferimento ai pacchetti interni con workspace:*. pnpm risolve il riferimento al pacchetto locale; durante la pubblicazione lo sostituisce con una versione reale.

pnpm -r esegue uno script in ogni pacchetto. Utilizzi --filter per selezionare un sottoinsieme.

Per impostazione predefinita, pnpm utilizza i symlink, quindi un pacchetto vede solo le dipendenze dichiarate esplicitamente nel proprio package.json. Non si verificano fughe accidentali tra pacchetti, un problema consentito sia da npm sia da yarn classic.

Per impostazione predefinita, pnpm non esegue alcun hoisting. Se una dipendenza transitiva deve essere accessibile (ad esempio TypeScript a livello globale), la aggiunga a .npmrc: shamefully-hoist=true (lo eviti se possibile) oppure utilizzi uno specifico public-hoist-pattern.

pnpm update aggiorna le dipendenze all'interno degli intervalli semver. pnpm update -L passa all'ultima versione, ignorando il caret.

pnpm fornisce workspace e installazione; Turborepo fornisce l'orchestrazione dei task e il caching. Si combinano perfettamente: la maggior parte dei monorepo JS utilizza entrambi.

Metta in cache lo store content-addressable di pnpm (~/.local/share/pnpm/store) per velocizzare la CI. Utilizzi --frozen-lockfile per interrompere l'esecuzione se pnpm-lock.yaml dovesse cambiare.

Qual è il principale vantaggio in termini di spazio su disco di pnpm rispetto a npm/yarn in un monorepo?

Un singolo store content-addressable + symlink = installazioni rapide e circa il 70% in meno di spazio su disco. pnpm-workspace.yaml elenca le cartelle dei pacchetti. Il protocollo workspace:* serve per le dipendenze interne. pnpm -r esegue gli script in tutti i pacchetti; --filter serve per i sottoinsiemi. La risoluzione rigorosa impedisce le dipendenze che fuoriescono dai pacchetti. Lo abbini a Turborepo per l'orchestrazione dei task. Utilizzi --frozen-lockfile nella CI.