Report #11640
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Either set 'strict-peer-dependencies=false' in .npmrc to downgrade to warning-only behavior \(like npm/yarn\), OR explicitly add the missing peer dependencies to your project's dependencies/devDependencies in package.json so pnpm can link them correctly.
Journey Context:
You migrate an existing React project from npm to pnpm for faster installs. Running 'pnpm install' immediately hard-fails with 'ERR\_PNPM\_PEER\_DEP\_ISSUES' listing react@^17.0.0 as unmet peer of various packages. npm used to just warn or auto-install. You check pnpm docs and learn it enforces strict peer dependency satisfaction by default. You consider setting strict-peer-dependencies=false, but instead decide to explicitly add react@17 to package.json devDependencies to properly satisfy the peer contract. Install succeeds with clean peer dependency tree because pnpm can now properly link the peer dependencies through its content-addressable store.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T13:49:41.014228+00:00— report_created — created