Workspaces pnpm para monorepos

pnpm (Performant npm) é um gerenciador de pacotes rápido e econômico em disco. Ele armazena uma única cópia de cada pacote em um armazenamento global endereçável por conteúdo e cria links para ela a partir de node_modules do projeto. Mesma dependência, vários projetos = uma cópia no disco.

Em um monorepo típico, as instalações do pnpm são de 2 a 3 vezes mais rápidas que as do npm/yarn e usam cerca de 70% menos espaço em disco. Os ganhos são enormes em monorepos com muitos pacotes.

Use o Corepack (incluído no Node 16+) ou instale globalmente.

Crie um pnpm-workspace.yaml na raiz, listando as pastas que contêm pacotes.

Cada aplicativo e pacote tem seu próprio package.json. A raiz tem um package.json do workspace com devDeps compartilhadas.

Execute pnpm install uma vez na raiz. O pnpm instala tudo em todos os pacotes, promovendo as dependências comuns.

Faça referência a pacotes internos com workspace:*. O pnpm resolve para o pacote local; ao publicar, substitui por uma versão real.

pnpm -r executa um script em todos os pacotes. Use --filter para subconjuntos.

Por padrão, o pnpm usa links simbólicos, portanto um pacote só consegue acessar as dependências que listou explicitamente em seu package.json. Não há vazamento acidental entre pacotes — um erro que tanto o npm quanto o yarn clássico permitem.

Por padrão, o pnpm não eleva nada. Se uma dependência transitiva precisar estar acessível (por exemplo, um TypeScript global), adicione ao .npmrc: shamefully-hoist=true (evite se possível) ou use um public-hoist-pattern específico.

pnpm update atualiza dentro dos intervalos semver. pnpm update -L atualiza para a versão mais recente (ignorando o acento circunflexo).

O pnpm fornece workspace + instalação; o Turborepo fornece orquestração de tarefas + armazenamento em cache. Eles formam uma combinação perfeita — a maioria dos monorepos de JS usa ambos.

Armazene em cache o armazenamento endereçável por conteúdo do pnpm (~/.local/share/pnpm/store) para acelerar a CI. Use --frozen-lockfile para falhar caso o pnpm-lock.yaml fosse alterado.

Qual é a principal vantagem do pnpm sobre npm/yarn em relação ao espaço em disco em um monorepo?

Um único armazenamento endereçável por conteúdo + links simbólicos = instalações rápidas e cerca de 70% menos espaço em disco. pnpm-workspace.yaml lista as pastas de pacotes. O protocolo workspace:* é usado para dependências internas. pnpm -r executa scripts em todos os pacotes; --filter é usado para subconjuntos. A resolução estrita impede o vazamento de dependências. Combine com o Turborepo para orquestração de tarefas. Use --frozen-lockfile na CI.