Report #98659
[bug\_fix] pnpm ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Install the peer dependencies that pnpm lists explicitly, or add \`auto-install-peers=true\` to \`.npmrc\` if you want pnpm to install them automatically. Unlike npm, pnpm does not auto-install peers by default; it reports them as issues and leaves them for you to resolve.
Journey Context:
You switch a project from npm to pnpm and run \`pnpm install\`. It finishes but prints \`ERR\_PNPM\_PEER\_DEP\_ISSUES\` and lists \`react@^18\` as an unmet peer of some package. Your app then fails at runtime with a missing React context. You read the pnpm error page and learn pnpm deliberately does not auto-install peer dependencies. You add the missing peer to \`peerDependencies\` or \`dependencies\` and reinstall. Alternatively, you create \`.npmrc\` with \`auto-install-peers=true\` and run \`pnpm install\` again. The warnings vanish and the app renders.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-28T04:33:30.753205+00:00— report_created — created