Create pnpm-workspace.yaml
Define the workspace root and included package globs.
bashANYpnpmworkspaceyaml
bash
cat > pnpm-workspace.yaml <<'YAML'
packages:
- packages/*
- apps/*
YAMLNotes
Define the workspace root and included package globs.
pnpm Workspaces
Workspace setup, filtering, recursive execution, deploy flows, and catalogs.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Workspace Basics
Create and manage pnpm workspaces.
Install workspace dependencies
Inside a workspace, pnpm installs dependencies for all projects by default.
bashANYpnpmworkspaceinstall
bash
pnpm installNotes
Inside a workspace, pnpm installs dependencies for all projects by default.
List workspace packages
Show workspace packages and their top-level dependencies.
bashANYpnpmworkspacelist
bash
pnpm -r list --depth 0Notes
Show workspace packages and their top-level dependencies.
Run command from workspace root only
Run a command in the workspace root context.
bashANYpnpmworkspaceroot
bash
pnpm -w exec node -p process.cwd()Notes
Run a command in the workspace root context.
Add a dependency to workspace root
Install a dependency into the workspace root package.json.
bashANYpnpmworkspacerootadd
bash
pnpm add -w -D typescriptNotes
Install a dependency into the workspace root package.json.
Workspace Filter Recipes
Useful selector patterns for targeted commands.
bash
pnpm --filter @acme/api buildNotes
Target a single package by name.
bash
pnpm --filter @acme/core... testNotes
Run command on a package and all dependents.
Filter dependencies
Run command on a package and all its dependencies.
bashANYpnpmworkspacefilterdependencies
bash
pnpm --filter ...@acme/web buildNotes
Run command on a package and all its dependencies.
Filter changed since branch
Target packages changed since a Git ref and their dependents.
bashANYpnpmworkspacefiltergit
bash
pnpm --filter "...[origin/main]" testNotes
Target packages changed since a Git ref and their dependents.
bash
pnpm --filter "@acme/*" lintNotes
Target packages that match a glob pattern.
bash
pnpm --filter ./packages/ui... buildNotes
Target packages selected by filesystem path.
Deploy, Catalogs, and Workspace Features
Advanced workspace capabilities.
Deploy one workspace package
Copy a package with isolated production dependencies to a target directory.
bashANYpnpmworkspacedeploy
bash
pnpm --filter @acme/web deploy distNotes
Copy a package with isolated production dependencies to a target directory.
Define a workspace catalog
Define reusable dependency versions in a workspace catalog.
bashANYpnpmworkspacecatalog
bash
cat >> pnpm-workspace.yaml <<'YAML'
catalog:
react: ^18.3.1
typescript: ^5.8.2
YAMLNotes
Define reusable dependency versions in a workspace catalog.
Publish changed workspace packages
Publish all packages in a workspace whose new versions are not yet in the registry.
bashANYpnpmworkspacepublish
bash
pnpm publish -rNotes
Publish all packages in a workspace whose new versions are not yet in the registry.
bash
pnpm -r rebuildNotes
Run rebuild across workspace packages.
Prune node_modules in all packages
Remove devDependencies from workspace package installs for production prep.
bashANYpnpmworkspacepruneprod
bash
pnpm -r prune --prodNotes
Remove devDependencies from workspace package installs for production prep.
More in pnpm
pnpm CI, Env, and Patching
CI installs, fetch, production pruning, Node runtime management, patching, and troubleshooting.
pnpm Publish and Registry
Pack, publish, dist-tags, registries, auth, and package metadata queries.
pnpm Config and Store
Configuration, .npmrc, store/cache operations, and installation model settings.
pnpm Install and Dependencies
Dependency types, package sources, versions, lockfiles, and reproducible installs.
pnpm Cheat Sheet
Comprehensive pnpm CLI reference for installs, dependency management, scripts, filtering, and inspection.