This document describes some policies around what is and is not included in the Node.js distribution.
The Node.js distribution includes some external software that the Node.js project does not maintain. The choice to include a particular piece of software should not imply anything about that software relative to its competitors; in some cases, software was added when it had no competitors. While the Node.js project supports and encourages competition in the JavaScript ecosystem, as a policy, the Node.js project does not include multiple dependencies or tools that serve the same purpose.
The following user-accessible external tools or libraries are the ones chosen for their particular purposes:
- JavaScript engine: V8
- Package manager:
npm - Package manager version manager: Corepack
Being user-accessible, removal or replacement of these projects could happen only as a semver-major change, unless the related feature or project is documented as experimental. In addition, Node.js includes external projects as internal dependencies. These may be replaced or removed at any time, provided that doing so is not a breaking change.
Installing Node.js will not create "placeholder" executables for package
managers. A placeholder executable is a binary, symlink or script that has a
name that refers to software that is not distributed with Node.js, but instead
would be downloaded when the executable is run. For example, Node.js will not
create yarn or download_yarn placeholder executables that will download Yarn
when run. Node.js includes npm and npx executables, but these are not
placeholders because the name of the executable refers to software that is
contained within the Node.js distribution.
Adding placeholder executables that refer to other types of software besides package managers will first require an affirmative vote of the Node.js Technical Steering Committee.