Report #38676
[bug\_fix] ERR\_PNPM\_PEER\_DEP\_ISSUES Unmet peer dependencies
Create a .npmrc file in the project root with auto-install-peers=true to allow pnpm to automatically install missing peer dependencies, or set strict-peer-dependencies=false to convert the error into a warning. Alternatively, manually add the missing peer dependencies to devDependencies.
Journey Context:
Migrated a monorepo from Yarn 1 to pnpm for better workspace support and disk efficiency. Ran pnpm install in the root. Instead of success, pnpm output a massive list of 'ERR\_PNPM\_PEER\_DEP\_ISSUES' listing dozens of unmet peer dependencies for ESLint plugins, React, and TypeScript. The install aborted. Checked documentation and realized pnpm is strict about peer dependencies by default, unlike npm or Yarn 1 which silently ignore missing peers. Manually adding each peer to the root package.json was impractical. Created a .npmrc with auto-install-peers=true and ran install again. pnpm automatically hoisted and installed all required peer dependencies into the virtual store, and the monorepo bootstrapped successfully.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T19:23:23.493317+00:00— report_created — created