Report #66684
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Install missing peer dependencies explicitly in devDependencies, or set strict-peer-dependencies=false in .npmrc to allow the build to proceed
Journey Context:
Developer switches from npm to pnpm for faster installs. Runs pnpm install on an existing project. Instead of warnings, pnpm hard-fails with 'ERR\_PNPM\_PEER\_DEP\_ISSUES' listing unmet peer dependencies \(e.g., 'react@^16.8.0 is a peer dependency of react-router but none was installed'\). Tries pnpm install --force, still fails. Realizes pnpm enforces peer dependencies strictly by default, unlike npm which ignored them or npm 7\+ which auto-installed them. Must either explicitly add the peer deps to package.json \(correct but tedious\), or configure .npmrc with strict-peer-dependencies=false to allow the build to proceed \(matching npm's old behavior\). Once fixed, understands pnpm's strictness prevents runtime errors from missing peers.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T18:24:36.664770+00:00— report_created — created