Dependencies

Lockfile

• Run pnpm dedupe after any lockfile change. CI fails if pnpm-lock.yaml is not deduplicated (pnpm lint:deps).
• Site template dependencies live in packages/create-docusaurus/templates/. Never edit examples/, it is CLI-generated.

Catalogs

All the monorepo dependencies are declared in the pnpm catalogs of pnpm-workspace.yaml. Packages reference them with the catalog protocol instead of a version range:

• "catalog:": the default catalog, for dependencies used at runtime by at least one package (dependencies, optionalDependencies or peerDependencies).
• "catalog:dev": the dev catalog, for dependencies only used as devDependencies.

Use pnpm commands to add and remove dependencies:

• pnpm add only accepts catalog versions (catalogMode: strict), and adds new dependencies to the default catalog. Move dev-only dependencies to the dev catalog.
• pnpm remove removes the catalog entries that are no longer used (catalogPrune: true). Manual package.json edits don't.