How to fix npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency tree npm ERR! peer dep missing in npm

What this error means

npm v7+ enforces peer dependencies strictly. When two packages demand incompatible peer versions (e.g., plugin wants React 17 while you installed React 18), the resolver aborts with ERESOLVE and shows a conflict tree.

Typical symptoms

• npm install fails with ERESOLVE and a dependency tree showing peer conflict
• Plugins requiring older framework versions block install
• Works only with --legacy-peer-deps or --force

Common causes

1. Packages require incompatible peer versions (e.g., React 17 vs React 18)
2. Lockfile pins versions outside declared peer ranges
3. Mixing majors of a framework and its ecosystem plugins

How to fix "npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency tree npm ERR! peer dep missing"

npm install react@17 react-dom@17
# or upgrade plugin to support React 18
npm install some-plugin@latest

rm -rf node_modules package-lock.json
npm install

{
  "overrides": {
    "some-plugin/react": "18.0.0"
  }
}

Advanced notes

Frequently asked questions

What does "npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency" mean?

npm v7+ enforces peer dependencies strictly. , plugin wants React 17 while you installed React 18), the resolver aborts with ERESOLVE and shows a conflict tree.

How do I fix "npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency"?

npm cannot pick a compatible set of dependencies because peer requirements conflict. Align versions (or upgrade both sides) and reinstall.

What causes "npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency"?

Packages require incompatible peer versions (e.g., React 17 vs React 18) Lockfile pins versions outside declared peer ranges Mixing majors of a framework and its ecosystem plugins

Is the "npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• npm ERR! code EABORT npm ERR! Aborted

  How to fix "EABORT: Aborted" npm error

  MEDIUM

• npm ERR! code ERESOLVE npm ERR! ERESOLVE overriding peer dependency is not allowed

  How to fix "ERESOLVE override conflict" in npm

  MEDIUM

• npm ERR! canceled

  How to fix "npm ERR! canceled" installation error

  MEDIUM

• npm ERR! code ERESOLVE npm ERR! Could not resolve optional dependency

  How to fix "ERESOLVE could not resolve optional dependency" in npm

  LOW

• npm ERR! code EAI_AGAIN

  How to fix "EAI_AGAIN" in npm

  MEDIUM

• npm ERR! code EPERM npm ERR! This operation requires administrator privileges

  How to fix "EPERM: This operation requires administrator privileges" in npm

  MEDIUM

Official resources & further reading

• 📚npm Official Documentation
• 📖
  npm Docs: peerDependencies(Official Docs)
• 📖
  npm Docs: legacy-peer-deps(Official Docs)
• 💬
  Stack Overflow: ERESOLVE unable to resolve dependency tree(Stack Overflow)
• 🐙
  npm/cli#4707 ERESOLVE conflicts(GitHub)