pnpm-workspace

Installation
SKILL.md

pnpm Workspace

Overview

pnpm workspaces provide built-in monorepo support through pnpm-workspace.yaml, the workspace: protocol for local package linking, and powerful filtering to run commands across specific packages. Catalogs enforce consistent dependency versions across all workspace packages.

When to use: Multi-package repositories, shared libraries with consuming apps, consistent dependency management across packages, running commands on subsets of packages.

When NOT to use: Single-package projects, projects already using npm/yarn workspaces (migration required), projects that need floating dependency versions per package.

Quick Reference

Pattern API / Config Key Points
Define workspace pnpm-workspace.yaml with packages globs Globs match directories containing package.json
Link local package "dep": "workspace:*" Always resolves to local workspace package
Link with version range "dep": "workspace:^1.0.0" Fails install if local version does not satisfy range
Default catalog catalog: key in pnpm-workspace.yaml Single source of truth for dependency versions
Named catalog catalogs: key with named groups Multiple version sets (e.g., react18, react17)
Related skills
Installs
78
GitHub Stars
11
First Seen
Feb 22, 2026