feat: add ASDF as community install option by 7487 · Pull Request #8847 · nodejs/nodejs.org

7487 · 2026-04-26T08:21:05Z

Description

Add ASDF (Another Setup Tool) as a community-maintained version manager option on the Node.js download page.

ASDF is a cross-platform version manager that supports Node.js along with many other languages/tools. It's widely used in the developer community and missing from the list of community install options.

Changes

Add ASDF entry to constants.json installMethods array with appropriate metadata (icon, URL, platform compatibility)
Add i18n translation string for ASDF description across all 12 locale files that include the platformInfo section

Co-Authored-By: Claude Opus 4.7 [email protected]

- Add ASDF entry to constants.json installMethods array - Add i18n strings for ASDF across all 12 locale files with platformInfo Co-Authored-By: Claude Opus 4.7 <[email protected]>

vercel · 2026-04-26T08:21:12Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nodejs-org	Ready	Preview	Apr 26, 2026 9:00am

cursor · 2026-04-26T08:21:14Z

PR Summary

Low Risk
Low risk: this only extends download-page configuration and localized strings, with no changes to runtime logic, security, or data handling.

Overview
Adds ASDF to the download page installMethods list in apps/site/util/download/constants.json (with icon, URL, and OS compatibility) so it can be selected as a community install method.

Adds the new i18n key layouts.download.codeBox.platformInfo.asdf across supported locale JSON files (and adjusts a couple of foundationName translations) to display ASDF’s platform description.

^{Reviewed by Cursor Bugbot for commit 2c29d15. Bugbot is set up for automated code reviews on this repo. Configure here.}

github-actions · 2026-04-26T08:21:16Z

👋 Codeowner Review Request

The following codeowners have been identified for the changed files:

Team reviewers: @nodejs/nodejs-website

Please review the changes when you have a chance. Thank you! 🙏

github-actions · 2026-04-26T08:21:21Z

Note

Your Pull Request seems to be updating Translations of the Node.js Website.

Whilst we appreciate your intent; Any Translation update should be done through our Crowdin Project.
We recommend giving a read on our Translation Guidelines.

Thank you!

cursor · 2026-04-26T08:24:48Z

    }
+     ,{
+       "id": "ASDF",
+       "icon": "asdf",


Missing icon component causes runtime crash

High Severity

The "icon": "asdf" value references a non-existent export from @node-core/ui-components/Icons/InstallationMethod. That module only exports Choco, Docker, FNM, Homebrew, N, NVM, and Volta — there is no asdf (or ASDF) export. The createIcon function will resolve IconModule["asdf"] to undefined, and React will crash when attempting to render <undefined />.

^{Reviewed by Cursor Bugbot for commit c21dac7. Configure here.}

cursor · 2026-04-26T08:24:48Z

          "choco": "Chocolatey est un gestionnaire de paquets pour Windows.",
          "docker": "Docker est une plateforme de conteneurisation.",
          "n": "\"n\" est un gestionnaire de versions Node.js multiplateforme.",
+          "asdf": "ASDF is a cross-platform version manager.",


Non-English locales have untranslated ASDF descriptions

Medium Severity

The asdf description string is English ("ASDF is a cross-platform version manager.") in all 11 non-English locale files (fr, id, ja, ko, pt-br, pt, ro, ta, uk, zh-cn, zh-tw). Every other entry in those files is properly translated into the respective language, so this breaks the localized user experience.

Additional Locations (2)

packages/i18n/src/locales/ja.json#L301-L302

packages/i18n/src/locales/zh-cn.json#L290-L291

^{Reviewed by Cursor Bugbot for commit c21dac7. Configure here.}

Copilot

Pull request overview

Adds ASDF as a community-maintained installation method on the site’s Node.js download page, along with a new platformInfo i18n string used in the download UI footer.

Changes:

Adds an ASDF entry to the download installMethods constants list (id, icon, URL, OS compatibility, info key).
Adds layouts.download.codeBox.platformInfo.asdf string entries across multiple locale JSON files.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 15 comments.

Show a summary per file

File	Description
packages/i18n/src/locales/zh-tw.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/zh-cn.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/uk.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/ta.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/ro.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/pt.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/pt-br.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/ko.json	Adds `platformInfo.asdf` string (currently English); also modifies `docker` line for comma.
packages/i18n/src/locales/ja.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/id.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/fr.json	Adds `platformInfo.asdf` string (currently English).
packages/i18n/src/locales/en.json	Adds the new English source string for `platformInfo.asdf`.
apps/site/util/download/constants.json	Adds ASDF to `installMethods` list (id/icon/url/info/compatibility).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-26T08:24:57Z

+       "id": "ASDF",
+       "icon": "asdf",
+       "name": "ASDF",
+       "compatibility": {
+         "os": ["MAC", "LINUX", "WIN"]


The new install method introduces a new id ("ASDF"). Please also update the InstallationMethod union in apps/site/types/release.ts to include this value; otherwise parts of the UI state and dropdown typing rely on unsafe casts and can get out of sync.

Copilot · 2026-04-26T08:24:58Z

    }
+     ,{
+       "id": "ASDF",
+       "icon": "asdf",
+       "name": "ASDF",
+       "compatibility": {
+         "os": ["MAC", "LINUX", "WIN"]
+       },
+       "url": "https://github.com/asdf-vm/asdf",
+       "info": "layouts.download.codeBox.platformInfo.asdf"
+     }


The array item separator is formatted as ,{ on its own line. This is valid JSON but inconsistent with the surrounding style and makes diffs harder to read. Prefer ending the previous object with a trailing comma and starting the next object on a new, properly indented line.

Suggested change

}

,{

"id": "ASDF",

"icon": "asdf",

"name": "ASDF",

"compatibility": {

"os": ["MAC", "LINUX", "WIN"]

},

"url": "https://github.com/asdf-vm/asdf",

"info": "layouts.download.codeBox.platformInfo.asdf"

}

},

{

"id": "ASDF",

"icon": "asdf",

"name": "ASDF",

"compatibility": {

"os": ["MAC", "LINUX", "WIN"]

},

"url": "https://github.com/asdf-vm/asdf",

"info": "layouts.download.codeBox.platformInfo.asdf"

}

Copilot · 2026-04-26T08:24:58Z

          "choco": "Chocolatey é um gerenciador de pacotes para Windows.",
          "docker": "Docker é uma plataforma de conteinerização.",
          "n": "\"n\" é um gerenciador de versões do Node.js multiplataforma.",
+          "asdf": "ASDF is a cross-platform version manager.",


This new pt-BR locale string is still in English. Please translate it to Brazilian Portuguese to keep platformInfo localized.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "\"ASDF\" é um gerenciador de versões multiplataforma.",

Copilot · 2026-04-26T08:24:58Z

          "choco": "ChocolateyはWIndows用のパッケージマネージャーです。",
          "docker": "Dockerはコンテナー化に関するプラットフォームです。",
          "n": "\"n\"はクロスプラットフォームに対応したNode.jsのバージョンマネージャーです。",
+          "asdf": "ASDF is a cross-platform version manager.",


This new Japanese locale string is still in English. Please provide a Japanese translation for consistency with the rest of platformInfo.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "\"ASDF\"はクロスプラットフォームに対応したバージョンマネージャーです。",

Copilot · 2026-04-26T08:24:58Z

          "choco": "Chocolatey 是 Windows 的套件管理程式。",
          "docker": "Docker 是一款容器化平台。",
          "n": "「n」是跨平台的 Node.js 版本管理程式。",
+          "asdf": "ASDF is a cross-platform version manager.",


This new zh-tw locale string is still in English. Please translate it to Traditional Chinese to match the rest of platformInfo (the other entries here are localized).

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "「ASDF」是跨平台的版本管理程式。",

Copilot · 2026-04-26T08:25:00Z

          "choco": "Chocolatey est un gestionnaire de paquets pour Windows.",
          "docker": "Docker est une plateforme de conteneurisation.",
          "n": "\"n\" est un gestionnaire de versions Node.js multiplateforme.",
+          "asdf": "ASDF is a cross-platform version manager.",


This new French locale string is still in English. Please translate it to French to match the other localized strings in platformInfo.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "\"ASDF\" est un gestionnaire de versions multiplateforme.",

Copilot · 2026-04-26T08:25:00Z

          "choco": "Chocolatey 是一款 Windows 软件包管理器。",
          "docker": "Docker 是一个容器化平台。",
          "n": "\"n\" 是一个跨平台的 Node.js 版本管理器。",
+          "asdf": "ASDF is a cross-platform version manager.",


This new zh-cn locale string is still in English. Please translate it to Simplified Chinese to keep platformInfo localized.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "ASDF 是一个跨平台的版本管理器。",

Copilot · 2026-04-26T08:25:00Z

          "choco": "Chocolatey — це менеджер пакетів для Windows.",
          "docker": "Docker — це платформа контейнеризації.",
          "n": "«n» — це кросплатформний менеджер версій Node.js.",
+          "asdf": "ASDF is a cross-platform version manager.",


This new Ukrainian locale string is still in English. Please provide a Ukrainian translation for consistency with the rest of platformInfo.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "«ASDF» — це кросплатформний менеджер версій.",

Copilot · 2026-04-26T08:25:00Z

          "choco": "Chocolatey என்பது Windows இற்கான பேக்கேஜ் மேலாளர்.",
          "docker": "Docker என்பது containerization தளம்.",
          "n": "\"n\" குறுக்கு-பிளாட்ஃபார்ம் Node பதிப்பு மேலாளர்.",
+          "asdf": "ASDF is a cross-platform version manager.",


This new Tamil locale string is still in English. Please translate it to Tamil so the platformInfo block remains localized.

Suggested change

"asdf": "ASDF is a cross-platform version manager.",

"asdf": "ASDF என்பது ஒரு குறுக்கு-பிளாட்ஃபார்ம் பதிப்பு மேலாளர்.",

Copilot · 2026-04-26T08:25:01Z

          "brew": "Homebrew는 macOS와 Linux용 패키지 관리자입니다.",
          "choco": "Chocolatey는 Windows용 패키지 관리자입니다.",
-          "docker": "Docker는 컨테이너화 플랫폼입니다. "
+          "docker": "Docker는 컨테이너화 플랫폼입니다. ",


While touching this line to add the trailing comma, consider removing the trailing space inside the string value (it will render as an extra space in the UI).

Suggested change

"docker": "Docker는 컨테이너화 플랫폼입니다. ",

"docker": "Docker는 컨테이너화 플랫폼입니다.",

- fr.json: revert "Fondation OpenJS" back to "OpenJS Foundation" - ta.json: revert Tamil translation back to "OpenJS Foundation" Per previous PR nodejs#6847, OpenJS Foundation is a proper noun and should not be translated in any locale. Co-Authored-By: Claude Opus 4.7 <[email protected]>

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

There are 4 total unresolved issues (including 2 from previous reviews).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2c29d15. Configure here.}

cursor · 2026-04-26T09:02:12Z

+       "icon": "asdf",
+       "name": "ASDF",
+       "compatibility": {
+         "os": ["MAC", "LINUX", "WIN"]


ASDF incorrectly listed as Windows-compatible

Medium Severity

The ASDF compatibility includes "WIN" in its os array, but ASDF does not natively support Windows — it only works through WSL2. Every other Unix-based version manager in the list (nvm, fnm, n, brew) correctly limits compatibility to ["MAC", "LINUX"]. Including "WIN" will cause ASDF to appear as an installation option for Windows users, who will then find it doesn't work on their platform.

^{Reviewed by Cursor Bugbot for commit 2c29d15. Configure here.}

cursor · 2026-04-26T09:02:12Z

        "legal": "Copyright © <foundationName>OpenJS Foundation</foundationName> et les contributeurs Node.js. Tous droits réservés.\nLa <foundationName>OpenJS Foundation</foundationName> détient des marques déposées et utilise des marques commerciales.\nPour consulter la liste des marques de la <foundationName>OpenJS Foundation</foundationName>, veuillez vous référer à notre <trademarkPolicy>Politique relative aux marques</trademarkPolicy> ainsi qu’à la <trademarkList>Liste des marques</trademarkList>.\nLes marques et logos qui ne figurent pas dans la <trademarkList>liste des marques de la OpenJS Foundation</trademarkList> sont des marques commerciales™ ou des marques déposées® appartenant à leurs détenteurs respectifs. Leur utilisation n’implique aucune affiliation ni approbation de leur part.",
        "links": {
-          "foundationName": "Fondation OpenJS",
+          "foundationName": "OpenJS Foundation",


Unrelated locale changes revert translated foundation name

Low Severity

In fr.json, foundationName was changed from the French translation "Fondation OpenJS" to the English "OpenJS Foundation". Similarly in ta.json, it was changed from the Tamil "OpenJS நிறுவனம்" to "OpenJS Foundation". These are unrelated to the ASDF feature and appear to be accidental reversions of localized strings back to English.

Additional Locations (1)

packages/i18n/src/locales/ta.json#L6-L7

^{Reviewed by Cursor Bugbot for commit 2c29d15. Configure here.}

avivkeller · 2026-04-26T17:36:23Z

Duplicate of #8800

feat: add ASDF as community install option on download page

c21dac7

- Add ASDF entry to constants.json installMethods array - Add i18n strings for ASDF across all 12 locale files with platformInfo Co-Authored-By: Claude Opus 4.7 <[email protected]>

7487 requested a review from a team as a code owner April 26, 2026 08:21

Copilot AI review requested due to automatic review settings April 26, 2026 08:21

Copilot started reviewing on behalf of 7487 April 26, 2026 08:21 View session

vercel Bot deployed to Preview April 26, 2026 08:22 View deployment

cursor Bot reviewed Apr 26, 2026

View reviewed changes

Copilot AI reviewed Apr 26, 2026

View reviewed changes

vercel Bot deployed to Preview April 26, 2026 09:00 View deployment

cursor Bot reviewed Apr 26, 2026

View reviewed changes

avivkeller marked this as a duplicate of #8800 Apr 26, 2026

avivkeller closed this Apr 26, 2026

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "\"ASDF\" é um gerenciador de versões multiplataforma.",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "\"ASDF\"はクロスプラットフォームに対応したバージョンマネージャーです。",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "「ASDF」是跨平台的版本管理程式。",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "\"ASDF\" est un gestionnaire de versions multiplateforme.",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "ASDF 是一个跨平台的版本管理器。",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "«ASDF» — це кросплатформний менеджер версій.",

	"asdf": "ASDF is a cross-platform version manager.",
	"asdf": "ASDF என்பது ஒரு குறுக்கு-பிளாட்ஃபார்ம் பதிப்பு மேலாளர்.",

	"docker": "Docker는 컨테이너화 플랫폼입니다. ",
	"docker": "Docker는 컨테이너화 플랫폼입니다.",

Conversation

7487 commented Apr 26, 2026

Description

Changes

Uh oh!

vercel Bot commented Apr 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Apr 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

github-actions Bot commented Apr 26, 2026

👋 Codeowner Review Request

Uh oh!

github-actions Bot commented Apr 26, 2026

Uh oh!

cursor Bot Apr 26, 2026

Choose a reason for hiding this comment

Missing icon component causes runtime crash

Uh oh!

cursor Bot Apr 26, 2026

Choose a reason for hiding this comment

Non-English locales have untranslated ASDF descriptions

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Apr 26, 2026

Choose a reason for hiding this comment

ASDF incorrectly listed as Windows-compatible

Uh oh!

cursor Bot Apr 26, 2026

Choose a reason for hiding this comment

Unrelated locale changes revert translated foundation name

Uh oh!

avivkeller commented Apr 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

vercel Bot commented Apr 26, 2026 •

edited

Loading

cursor Bot commented Apr 26, 2026 •

edited

Loading