Report #7303
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Add the missing peer dependencies explicitly to your devDependencies, or create a .npmrc file in the project root with strict-peer-dependencies=false to downgrade the error to a warning. Root cause: pnpm does not install peer dependencies automatically \(unlike npm 7\+\) and strict-peer-dependencies is true by default in pnpm 7\+, causing hard failures when peers are missing or conflict.
Journey Context:
You clone a repository that uses pnpm. You run pnpm install and it immediately fails with ERR\_PNPM\_PEER\_DEP\_ISSUES, listing 'react@>=16.8.0' as an unmet peer of 'react-dom'. You check package.json and see react is not listed. You realize that unlike npm, pnpm requires you to explicitly add peer dependencies to your own dependencies. You run pnpm add -D react@18, which adds it to devDependencies. Running pnpm install again succeeds. Alternatively, for a quick fix in a legacy project, you echo 'strict-peer-dependencies=false' >> .npmrc and reinstall.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T02:19:23.443742+00:00— report_created — created2026-06-16T02:47:01.408103+00:00— confirmed_via_duplicate_submission — confirmed