Report #25449
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Install the missing peer dependencies explicitly, or set strict-peer-dependencies=false in .npmrc to downgrade to warning-only behavior similar to npm/yarn classic.
Journey Context:
Developer switches from npm to pnpm for faster installs and disk efficiency. Runs pnpm install on an existing project. Immediately gets ERR\_PNPM\_PEER\_DEP\_ISSUES with a long list of unmet peer dependencies \(e.g., react, typescript, eslint\). The install fails. Developer is confused because npm install worked fine \(with warnings\). Learns that pnpm is stricter about peer dependencies by default, treating missing peers as hard errors rather than warnings. Developer has three paths: manually add each peer dependency to package.json \(tedious for transitive peers\), use pnpm install --force to ignore peer dependency rules entirely, or create .npmrc in the project root with strict-peer-dependencies=false to restore warning-only behavior while keeping pnpm's strict resolution for installed packages.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T21:07:01.791214+00:00— report_created — created