How to fix npm ERR! code ERESOLVE npm ERR! ERESOLVE overriding peer dependency is not allowed in npm

npmINTERMEDIATEMEDIUM

An override you set conflicts with dependency resolution. Adjust or remove the override, or align versions so the override matches the graph.

What this error means

npm overrides (package.json "overrides") force specific versions. If the forced version conflicts with peer/dep requirements, the resolver errors with ERESOLVE override conflict.

Typical symptoms

npm install fails with ERESOLVE and mentions overrides
Override version does not satisfy declared peer ranges
Install only succeeds if override is removed

Common causes

Override forces a version outside peer ranges
Multiple overrides clash on the same dependency
Override pins an older major incompatible with dependents

How to fix "npm ERR! code ERESOLVE npm ERR! ERESOLVE overriding peer dependency is not allowed"

1Inspect the ERESOLVE output

Read which package and version the override is forcing and what peer/dep range it violates.

2Adjust or remove the override

Pick a version that satisfies peers, or delete the override entirely and let npm resolve naturally.

3Align dependent packages if needed

Upgrade/downgrade the dependent package so its peers match the override target.

4Reinstall cleanly

Refresh resolution after changes:

bash

rm -rf node_modules package-lock.json
npm install

Advanced notes

Use overrides sparingly—prefer upgrading the real dependency. Overrides that fight peers often cause runtime breakage.

Related errors

Official resources & further reading

📚npm Official Documentation
📖
npm Docs: overrides(Official Docs)
📖
npm Docs: legacy-peer-deps(Official Docs)
💬
Stack Overflow: npm overrides conflicts(Stack Overflow)
🐙
npm/cli#4707 - ERESOLVE conflicts(GitHub)