Manage Node.js version in a Foundry code repository（在 Foundry 代码仓库中管理 Node.js 版本）¶
Foundry code repositories support Node Version Manager (nvm) ↗ to manage the Node.js version used in your project and CI. By adding an .nvmrc file to the root of your repository, you can specify which Node.js version your project uses.
:::callout{theme="neutral"}
If you do not use nvm, the CI will use the Node.js version specified in .jemma/settings.sh and the Foundry development environment will use version 18.20.8.
:::
Add an .nvmrc file¶
To set a Node.js version for your repository, create a file named .nvmrc in the root of your project. This file should contain only the version number of Node.js you want to use, prefixed with v, for example:
v24.13.0
You can view available Node.js versions by running nvm ls-remote in a terminal within your code repository.
Use the specified version¶
After adding the .nvmrc file, run the following command in the terminal to switch to the version defined in the file:
nvm install
Configure CI to use the .nvmrc version¶
To ensure your CI builds use the same Node.js version specified in your .nvmrc file, update the .jemma/settings.sh file in your repository.
Replace the existing NODE_INSTALLATION_VERSION export with the following line, which reads the version directly from your .nvmrc file:
export NODE_INSTALLATION_VERSION=$(sed 's/^v//' "$(dirname "${BASH_SOURCE[0]}")/../.nvmrc")
With this change, you only need to update the .nvmrc file to change the Node.js version for both your Foundry development and CI environments.
中文翻译¶
在 Foundry 代码仓库中管理 Node.js 版本¶
Foundry 代码仓库支持使用 Node Version Manager (nvm，Node 版本管理器) ↗(https://github.com/nvm-sh/nvm) 来管理项目及 CI 中使用的 Node.js 版本。通过在仓库根目录添加 .nvmrc 文件，您可以指定项目所使用的 Node.js 版本。
:::callout{theme="neutral"}
如果您不使用 nvm，CI 将使用 .jemma/settings.sh 中指定的 Node.js 版本，而 Foundry 开发环境将使用版本 18.20.8。
:::
添加 .nvmrc 文件¶
要为您的仓库设置 Node.js 版本，请在项目根目录创建一个名为 .nvmrc 的文件。该文件应仅包含您要使用的 Node.js 版本号，并以 v 开头，例如：
v24.13.0
您可以通过在代码仓库的终端中运行 nvm ls-remote 命令来查看可用的 Node.js 版本。
使用指定版本¶
添加 .nvmrc 文件后，在终端中运行以下命令，即可切换到文件中定义的版本：
nvm install
配置 CI 使用 .nvmrc 版本¶
为确保 CI 构建使用 .nvmrc 文件中指定的 Node.js 版本，请更新仓库中的 .jemma/settings.sh 文件。
将现有的 NODE_INSTALLATION_VERSION 导出语句替换为以下内容，该命令会直接从您的 .nvmrc 文件中读取版本号：
export NODE_INSTALLATION_VERSION=$(sed 's/^v//' "$(dirname "${BASH_SOURCE[0]}")/../.nvmrc")
通过此更改，您只需更新 .nvmrc 文件，即可同时更改 Foundry 开发环境和 CI 环境中的 Node.js 版本。