npm
npm WARN Could not resolve dependency: peer xxx
Peer Dependency Warning
A package expects a peer dependency (e.g., React, webpack) that isn't installed or has a version mismatch.
Common Causes
- Peer not installed
- Version mismatch (e.g., React 17 vs 18)
- Monorepo with conflicting versions
- Legacy package with outdated peer range
Fixes
- 1. Install the peer explicitly
npm install react@^18.0.0
- 2. Use --legacy-peer-deps to bypass
npm install --legacy-peer-deps
- 3. Override in package.json
"overrides": { "react": "^18.0.0" }
Still not fixed?
- • Search the exact error message on Stack Overflow or GitHub Issues
- • Check the official docs for the language or tool
- • Ensure your versions (Node, Python, npm, Docker) are up to date
- • Try in a minimal reproduction (new project, single file)
Related Errors
DuskTools That Might Help
All Errors
JavaScript Heap Out of MemoryModuleNotFoundErrorAddress Already in UseIndentationErrorCannot Find ModuleCORS Policy BlockedTypeError: 'NoneType' Not SubscriptableMerge ConflictDocker Port Already AllocatedENOENT: No Such File or DirectoryKeyErrorMaxListenersExceededWarningRecursionErrorDetached HEAD StateEACCES: Permission DeniedValueErrorNo Space Left on DeviceERR_REQUIRE_ESMFileNotFoundError