Report #99590
[bug\_fix] pnpm ERR\_PNPM\_PEER\_DEP\_ISSUES: Unmet peer dependencies
Add the missing peer dependencies explicitly to package.json dependencies/devDependencies, or configure \`pnpm.peerDependencyRules.ignoreMissing\` in package.json if the package's peer requirement is optional and unused. For auto-installation behavior similar to npm, set \`auto-install-peers=true\` in .npmrc \(not recommended for reproducible lockfiles\).
Journey Context:
You migrate a project from npm to pnpm and run \`pnpm install\`. The install succeeds but prints a wall of "ERR\_PNPM\_PEER\_DEP\_ISSUES" warnings naming packages like react-dom, eslint, and typescript that are peer dependencies of your dependencies but not installed. With npm 7\+ these would have been auto-installed; pnpm defaults to warning instead. Your CI then fails because pnpm treats unmet peer issues as errors. You verify the warnings with \`pnpm list --depth=0\` and read the pnpm error page. The cleanest fix is to add the peers you actually need to devDependencies, giving you explicit control over their versions and removing the CI failures.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-30T04:43:44.931311+00:00— report_created — created