---
name: pnpm
description: Use when managing Node.js dependencies with pnpm - install packages, configure monorepo workspaces, set up pnpm catalogs, resolve dependency conflicts with overrides, patch third-party packages, and configure CI pipelines for pnpm projects
license: MIT
---

# pnpm

Content-addressable store, strict deps, workspace protocol, catalogs.

## When to Use

- Installing/managing npm packages
- Monorepo workspace setup with catalogs
- Overriding transitive dependencies
- Patching third-party packages
- CI/CD configuration for pnpm projects
- Supply chain security hardening

## Quick Start

```bash
pnpm install                      # Install deps
pnpm add <pkg>                    # Add dep
pnpm add -D <pkg>                 # Dev dep
pnpm -r run build                 # Run in all packages
pnpm --filter @myorg/app build    # Run in specific package
```

## Workspace Setup

```yaml
# pnpm-workspace.yaml
packages:
  - 'packages/*'
  - 'apps/*'

# Catalogs for centralized version management
catalog:
  react: ^18.2.0
  typescript: ~5.3.0
```

```json
// package.json - Use workspace protocol and catalogs
{
  "packageManager": "pnpm@10.28.2",
  "dependencies": {
    "@myorg/utils": "workspace:^",
    "react": "catalog:"
  }
}
```

## Reference Files

| Task                             | File                                      |
| -------------------------------- | ----------------------------------------- |
| Commands, scripts, filtering     | [cli.md](references/cli.md)               |
| Workspaces, catalogs, config     | [workspaces.md](references/workspaces.md) |
| Overrides, patches, hooks, store | [features.md](references/features.md)     |
| CI/CD, Docker, migration         | [ci.md](references/ci.md)                 |

## Loading Files

**Consider loading these reference files based on your task:**

- [ ] [references/cli.md](references/cli.md) - if using pnpm commands, scripts, or filtering
- [ ] [references/workspaces.md](references/workspaces.md) - if setting up monorepo, catalogs, or workspace config
- [ ] [references/features.md](references/features.md) - if using overrides, patches, hooks, or managing store
- [ ] [references/ci.md](references/ci.md) - if configuring CI/CD, Docker, or migrating from npm/yarn

**DO NOT load all files at once.** Load only what's relevant to your current task.

## Verify Setup

After configuring a workspace, verify it works:

```bash
pnpm install          # Install all deps
pnpm ls --depth 0     # Verify workspace links
pnpm -r run build     # Build all packages
```

## Cross-Skill References

- **TypeScript libs** → Use `ts-library` skill for library patterns
- **Build tooling** → Use `tsdown` or `vite` skills