pnpm — Fast, Disk-Space Efficient Package Manager

What pnpm Does

• Fast installs — 2-3x faster than npm
• Disk efficient — global content-addressable store (~/.pnpm-store)
• Strict node_modules — no phantom dependencies
• Monorepo — first-class workspace support
• Deterministic — pnpm-lock.yaml
• Catalogs — shared version ranges across workspace
• Patches — patch-package built in

Architecture

Global store at ~/.pnpm-store/v3 holds all package tarballs (content-addressed). Each project gets a node_modules/.pnpm directory with hardlinks to the store, then symlinks in node_modules/ to expose direct deps. Non-direct deps stay hidden (no phantom deps).

Self-Hosting

CLI tool — install locally, no server.

Key Features

• 2-3x faster than npm/yarn classic
• Up to 50% disk space savings
• Strict dependency resolution
• Workspace/monorepo first-class
• pnpm dlx for one-off commands
• Built-in pnpm patch for upstream fixes
• Catalogs (v9+) for shared versions
• Side-effects cache

Comparison

FAQ

Q: Will it break existing projects? A: A few older packages that rely on phantom deps will throw errors. Fix: add them explicitly to package.json or use public-hoist-pattern.

Q: Does it pair with Turborepo/Nx? A: Perfectly. pnpm handles dependencies; Turborepo/Nx handle task orchestration and caching.

Q: Can it replace Yarn workspaces? A: Yes. Migration usually just involves moving workspaces from package.json into a pnpm-workspace.yaml file.

Sources & Credits

• Docs: https://pnpm.io
• GitHub: https://github.com/pnpm/pnpm
• License: MIT