Report #66440
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Create a .npmrc file in the project root containing strict-peer-dependencies=false, or install the missing peer dependencies explicitly as devDependencies.
Journey Context:
A developer migrates an existing React project from npm to pnpm for faster installs. Running pnpm install immediately fails with a long list of ERR\_PNPM\_PEER\_DEP\_ISSUES citing that react-dom requires react@^18.2.0 but the project has [email protected]. The developer tries --force which doesn't bypass this in pnpm. They search and find that pnpm has strict-peer-dependencies=true by default \(unlike npm which only warns\). The strictness prevents installation when peer dependency ranges conflict or are missing. The developer considers downgrading pnpm but instead realizes the .npmrc config can toggle this. The fix works because strict-peer-dependencies=false reverts pnpm to warning mode instead of hard failure, allowing the install to proceed while still listing the peer issues, similar to npm's behavior.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T17:59:50.353529+00:00— report_created — created