npm ERESOLVE Error Debugging Prompt
Debug an npm ERESOLVE dependency-tree error from the exact command, peer-dependency conflict, package metadata, runtime versions, lockfile state, and minimal reproduction.
Prompt Template
You are a senior JavaScript package-management engineer helping me diagnose an npm ERESOLVE error from evidence. Work from the exact install command, complete sanitized error report, Node.js and npm versions, operating system, package.json files, workspace layout, lockfile, registry configuration, and package metadata I provide. Identify the smallest incompatible dependency or peer-dependency constraint and distinguish a direct version conflict, transitive conflict, stale lockfile, workspace mismatch, prerelease range, registry metadata issue, optional peer, platform constraint, or package-manager/version behavior. Never invent available releases, peer ranges, package ownership, changelog claims, security status, or a successful install. Do not default to `--force`, `--legacy-peer-deps`, broad overrides, deleting the lockfile, or upgrading unrelated packages before explaining the compatibility and reproducibility tradeoffs. Exact command and working directory: [paste] Complete ERESOLVE output and report path contents, with secrets and private URLs removed: [paste] Node.js, npm, operating-system, architecture, and shell versions: [details] Repository type and workspace layout: [single package, npm workspaces, monorepo, other] Relevant package.json files: [paste] Lockfile version and relevant dependency entries: [paste] Requested package and version or range: [details] Installed tree from safe read-only commands if available: [output] Registry and scope configuration, with tokens removed: [public or private; sanitized details] Package metadata, peer ranges, release notes, and source dates already verified: [details] Whether a clean minimal package reproduces the error: [result] Recent dependency, runtime, registry, or workspace changes: [details] Production, browser, framework, security, licensing, and compatibility constraints: [details] Provide: 1. A concise conflict statement naming the requester, requested version, incompatible peer range, and evidence location. 2. A dependency-tree diagram from the root package to each conflicting constraint. 3. An evidence table separating package.json requirements, lockfile state, registry metadata, installed state, assumptions, and unknowns. 4. Safe read-only commands to verify versions, peerDependencies, workspace ownership, registry source, and why the package is present, without exposing credentials. 5. A ranked root-cause list with each hypothesis tied to exact report lines and metadata. 6. Resolution options ordered from the smallest compatible version alignment through a supported package upgrade, downgrade, replacement, or upstream fix, with tradeoffs. 7. An explicit risk assessment for force, legacy peer-dependency mode, overrides, lockfile regeneration, and mixed package managers; recommend one only when justified. 8. Exact minimal edits for the best-supported option, clearly separating confirmed versions from placeholders. 9. Verification using a clean checkout or temporary reproduction, deterministic install, tests, build, runtime smoke check, dependency-tree inspection, and security review. 10. Rollback steps, lockfile review points, remaining unknowns, and the next single artifact to collect if compatibility is not proved. Redact registry tokens, credentials, private URLs, internal package contents, and user paths. Preserve the existing lockfile until evidence shows regeneration is required, and never claim two versions are compatible without verified metadata and tests.
Example Output
Conflict Statement
`[root package]` requests `[package A@range]`; that resolves to `[version]`, whose verified peer requirement is `[package B@range]`. The project currently requires `[package B@version]`, outside that range. The ERESOLVE report confirms the same edge; compatibility is not yet proved.
Safe Checks
npm explain [package-a]
npm view [package-a]@[version] peerDependencies --json
npm ls [package-a] [package-b] --all
Run these in the failing workspace with credentials and private registry URLs redacted.
Preferred Fix Shape
Choose the smallest supported version alignment backed by published peer metadata and release notes, edit only the relevant manifest range, then perform a clean deterministic install and run tests and the production build.
Avoid for Now
Do not use `--force`, `--legacy-peer-deps`, a broad override, or lockfile deletion until the incompatible edge and runtime risk are understood.
Tips for Best Results
- ๐กPaste the full sanitized ERESOLVE report; its `Found`, `Could not resolve dependency`, and peer-range lines usually identify the incompatible edge.
- ๐กInclude every relevant workspace manifest and the lockfile version because the root package.json may not own the failing dependency.
- ๐กTreat force flags and overrides as documented risk decisions, then verify with a clean install, tests, build, and dependency-tree inspection.
Frequently Asked Questions
What is the npm ERESOLVE Error Debugging Prompt prompt?
Debug an npm ERESOLVE dependency-tree error from the exact command, peer-dependency conflict, package metadata, runtime versions, lockfile state, and minimal reproduction. It's a free ChatGPT prompt template from our Coding collection โ copy it, fill in the bracketed variables, and paste it into your AI tool.
Which AI tools work with this prompt?
It's written and tested for ChatGPT, Claude and Gemini. Any AI assistant that accepts free-form text prompts will handle it well.
How do I customize this ChatGPT prompt?
Replace the bracketed variables โ such as [paste], [details], [output] โ with your own details before running it. Paste the full sanitized ERESOLVE report; its `Found`, `Could not resolve dependency`, and peer-range lines usually identify the incompatible edge.
Is this prompt free to use?
Yes. Every prompt on PromptAtlas is free to copy, customize, and use โ no signup required.
Related Prompts
Next.js Hydration Error Debugging Prompt
Debug a Next.js hydration error from the exact server HTML, first client render, component boundary, versions, console output, and minimal reproduction.
Python ModuleNotFoundError Debugging Prompt
Debug Python ModuleNotFoundError from the exact traceback, interpreter, environment, import path, project layout, packaging metadata, and launch command.
Segmentation Fault Debugging Prompt
Debug a segmentation fault from the exact crash signal, source, build flags, backtrace, sanitizer evidence, inputs, and runtime environment.
CORS Error Debugging Prompt
Debug a CORS error from the exact browser message, origins, preflight exchange, server stack, proxy path, credentials mode, and response headers.
CLAUDE.md Generator Prompt
Generate a concise CLAUDE.md repository instruction file from verified project commands, conventions, boundaries, and existing documentation.
GitHub Actions Workflow Generator Prompt
Generate a minimal GitHub Actions workflow from verified repository commands, events, runner needs, permissions, secrets, caching, and deployment constraints.