Files
pnpm/pnpm11/docs/settings/_catalogMode.mdx
Zoltan Kochan 07839df5c3 docs: move product documentation beside its implementation (#16385)
* docs: move website documentation into the pnpm repository

* docs: keep v11 and v12 documentation beside their implementations

* docs(pnpr): keep registry documentation beside its implementation

* ci: classify product documentation as documentation changes

* test: cover product documentation in Rust CI exclusions

* ci: isolate documentation publishing and support manual sync

* test: make dependency status fixture timestamps deterministic
2026-09-29 15:56:43 +02:00

15 lines
935 B
Plaintext

### catalogMode
Added in: v10.12.1
* Default: **manual**
* Type: **manual**, **strict**, **prefer**
Controls if and how dependencies are added to the default catalog, when running `pnpm add`. There are three modes:
- **strict** - only allows dependency versions from the catalog. Adding a dependency outside the catalog's version range will cause an error.
- **prefer** - prefers catalog versions, but will fall back to direct dependencies if no compatible version is found.
- **manual** (default) - does not automatically add dependencies to the catalog.
Since v11.26.0, a specifier that names a location rather than a version is never moved into a catalog: local paths, local tarballs, tarball URLs, and `workspace:<path>` ranges stay in the `package.json` that declares them. Such a specifier is resolved relative to its own project, so one catalog entry could not mean the same directory for every project that references it.