From cf42647ab45bb912a64d522e3c35a1178ba656d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8B=8F=E5=90=91=E5=A4=9C?= Date: Thu, 7 May 2026 13:48:50 +0800 Subject: [PATCH 1/4] docs(node): add tips for enable node idiomatic --- docs/lang/node.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/lang/node.md b/docs/lang/node.md index 11621f4e79..845c7d2cf8 100644 --- a/docs/lang/node.md +++ b/docs/lang/node.md @@ -57,6 +57,21 @@ It also supports `.tool-versions`, `.nvmrc` or `.node-version` file to find out This makes it a drop-in replacement for `nvm`. See [idiomatic version files](/configuration.html#idiomatic-version-files) for more information. +::: tip +`.nvmrc` and `.node-version` are disabled by default and must be explicitly enabled: + +```sh +mise settings add idiomatic_version_file_enable_tools node +``` + +Or in `~/.config/mise/config.toml`: + +```toml +[settings] +idiomatic_version_file_enable_tools = ["node"] +``` +::: + ## Default node packages mise-node can automatically install a default set of npm packages right after installing a node version. To enable this feature, provide a `$HOME/.default-npm-packages` file that lists one package per line, for example: From 51491e60b12ef10ff502b23654a3fc98c20fe784 Mon Sep 17 00:00:00 2001 From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com> Date: Thu, 7 May 2026 05:56:32 +0000 Subject: [PATCH 2/4] [autofix.ci] apply automated fixes --- docs/lang/node.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/lang/node.md b/docs/lang/node.md index 845c7d2cf8..d9d3f173d7 100644 --- a/docs/lang/node.md +++ b/docs/lang/node.md @@ -70,6 +70,7 @@ Or in `~/.config/mise/config.toml`: [settings] idiomatic_version_file_enable_tools = ["node"] ``` + ::: ## Default node packages From d2ab7b872e3948de1f0f9f25d8d9d8ab2751f819 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8B=8F=E5=90=91=E5=A4=9C?= Date: Thu, 7 May 2026 14:32:04 +0800 Subject: [PATCH 3/4] docs(node): optmize description --- docs/lang/node.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/lang/node.md b/docs/lang/node.md index d9d3f173d7..1a820ae42a 100644 --- a/docs/lang/node.md +++ b/docs/lang/node.md @@ -49,16 +49,16 @@ npm = "11.12.1" The pinned npm version takes precedence over the one bundled with Node, so `npm --version` will always return the version specified in `mise.toml`. -## `.nvmrc` and `.node-version` support +## `.nvmrc`, `.node-version` and `package.json` support By default, mise uses a `mise.toml` file for auto-switching between software versions. -It also supports `.tool-versions`, `.nvmrc` or `.node-version` file to find out what version of Node.js should be used. This will be used if `node` isn't defined in `mise.toml`. +It also supports `.tool-versions` file to specify versions for ASDF compatibility. Additionally, `.nvmrc`, `.node-version`, and the `engines` field in `package.json` are supported but require explicit enabling (see tip below). This makes it a drop-in replacement for `nvm`. See [idiomatic version files](/configuration.html#idiomatic-version-files) for more information. ::: tip -`.nvmrc` and `.node-version` are disabled by default and must be explicitly enabled: +Idiomatic version files (`.nvmrc`, `.node-version`, `engines` field in `package.json`) are disabled by default and must be explicitly enabled: ```sh mise settings add idiomatic_version_file_enable_tools node From a04cc07b7bd66a1a4081c79e865e27185b1c296c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8B=8F=E5=90=91=E5=A4=9C?= Date: Thu, 7 May 2026 14:37:38 +0800 Subject: [PATCH 4/4] docs(node): fix to use `devEngines` --- docs/lang/node.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/lang/node.md b/docs/lang/node.md index 1a820ae42a..b3887aadd8 100644 --- a/docs/lang/node.md +++ b/docs/lang/node.md @@ -53,12 +53,12 @@ always return the version specified in `mise.toml`. By default, mise uses a `mise.toml` file for auto-switching between software versions. -It also supports `.tool-versions` file to specify versions for ASDF compatibility. Additionally, `.nvmrc`, `.node-version`, and the `engines` field in `package.json` are supported but require explicit enabling (see tip below). +It also supports `.tool-versions` file to specify versions for ASDF compatibility. Additionally, `.nvmrc`, `.node-version`, and the `devEngines` field in `package.json` are supported but require explicit enabling (see tip below). This makes it a drop-in replacement for `nvm`. See [idiomatic version files](/configuration.html#idiomatic-version-files) for more information. ::: tip -Idiomatic version files (`.nvmrc`, `.node-version`, `engines` field in `package.json`) are disabled by default and must be explicitly enabled: +Idiomatic version files (`.nvmrc`, `.node-version`, `devEngines` field in `package.json`) are disabled by default and must be explicitly enabled: ```sh mise settings add idiomatic_version_file_enable_tools node