Report #9846
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Set strict-peer-dependencies=false in .npmrc or use pnpm install --no-strict-peer-deps to allow pnpm to install peer dependencies automatically and warn instead of erroring, matching npm/yarn behavior for legacy projects with complex peer dependency ranges.
Journey Context:
Developer migrates a large React monorepo from npm to pnpm for disk space efficiency. Runs pnpm install, immediately fails with ERR\_PNPM\_PEER\_DEP\_ISSUES listing multiple unmet peer dependencies \(react@17 required by @storybook/react but react@18 in root\). Confused because npm 6 installed these automatically. Diving into pnpm documentation reveals pnpm defaults to strict-peer-dependencies=true \(unlike npm/yarn\), treating peer dependency conflicts as hard errors to enforce explicit dependency declarations. The developer creates a .npmrc with strict-peer-dependencies=false, re-runs pnpm install, and pnpm auto-installs the peer dependencies with warnings, allowing the migration to proceed without manually resolving every peer conflict in the legacy codebase.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T09:14:35.765066+00:00— report_created — created