pnpm en la práctica

pnpm (Performant npm) es un reemplazo directo de npm con dos ideas clave: un store global en disco que solo guarda una copia de cada paquete, y una resolución estricta que evita las dependencias fantasma.

Por qué pnpm ahorra tanto espacio

Cuando haces npm install react, npm copia los archivos en tu-proyecto/node_modules/react/. Si tienes diez proyectos que usan React, tienes diez copias idénticas en el disco.

pnpm funciona de otra manera:

1. Descarga React una sola vez en un store global (~/.local/share/pnpm/store en Linux/macOS, %LOCALAPPDATA%\pnpm\store en Windows).
2. En cada proyecto, node_modules/react/ es un hardlink que apunta a los archivos del store. Un solo archivo físico, diez proyectos que acceden a él.

En concreto: en una máquina con diez proyectos React, npm ocupa ~400 MB por proyecto. pnpm ocupa ~40 MB (el store compartido) sin importar cuántos proyectos haya.

Instalar pnpm

Via npm (una sola vez):

$npm install -g pnpm

Via corepack (incluido en Node desde v16):

$corepack enable

$corepack prepare pnpm@latest --activate

Verifica:

$pnpm --version

Comandos habituales

Instalar todas las dependencias de un proyecto existente:

$pnpm install

Añadir un paquete:

$pnpm add react

Añadir una devDependency:

$pnpm add -D typescript

Lanzar un script definido en package.json:

$pnpm run dev

Atajo (sin run) para scripts habituales:

$pnpm dev

$pnpm build

$pnpm test

Ejecutar un comando puntual sin instalar globalmente:

$pnpm dlx create-next-app my-app

Actualizar todas las dependencias:

$pnpm update

Eliminar un paquete:

$pnpm remove lodash

Resolución estricta: adiós a las dependencias fantasma

pnpm crea una estructura node_modules/ no aplanada. Cada paquete solo puede ver sus propias dependencias declaradas. Tu código no puede acceder a lodash si no has añadido lodash explícitamente a tu package.json.

Puede parecer restrictivo, pero es una garantía: tu build es reproducible y no depende de las dependencias transitivas de tus dependencias.

pnpm y los monorepos

pnpm tiene el mejor soporte de monorepos entre los tres gestores. Un archivo pnpm-workspace.yaml en la raíz es suficiente para declarar varios paquetes:

packages:
  - "packages/*"
  - "apps/*"

Los paquetes del workspace pueden referenciarse entre sí con workspace:* como versión:

{
  "dependencies": {
    "@mi-proyecto/shared": "workspace:*"
  }
}