Understand your dependencies
A clearer path through
Node & npm compatibility.
Trace common compatibility errors from the package declaration to your runtime. Each guide includes practical checks, illustrative examples, and links to the official documentation.
How to investigate ERR_REQUIRE_ESM
Understand why require() reaches an ES module, how Node versions change the result, and when to use import() or migrate to ESM.
Read the guideHow to resolve a Node engine mismatch
Read engines.node ranges, investigate npm EBADENGINE warnings, and align local, CI, and deployment Node versions.
Read the guideHow conditional exports choose a package entry
Understand import, require, node, and default export conditions, why their order matters, and what metadata cannot prove.
Read the guideHow npm version ranges affect compatibility
Read caret and tilde ranges, understand 0.x and prerelease behavior, and separate a declared range from an installed version.
Read the guideApply it to a package
Check the declaration against your environment.
Choose a package release, Node version, and module format. Review engines and the root entry point before testing your application.
These guides explain package declarations. They do not claim that a package was installed or executed by NPMBot.