feat: adds asdf installation instructions to downloads page

JacobNWolf · JacobNWolf · commit 6a4a4ab5d7b6 · 2026-01-11T13:45:13.000-06:00
diff --git a/.tool-versions b/.tool-versions
@@ -0,0 +1,2 @@
+pnpm 10.24.0
+nodejs 24.12.0
diff --git a/apps/site/snippets/en/download/asdf.bash b/apps/site/snippets/en/download/asdf.bash
@@ -0,0 +1,20 @@
+# asdf has specific installation instructions for each operating system.
+# Please refer to the official documentation at https://asdf-vm.com/guide/getting-started.html.
+#
+# The following is for MacOS and Linux systems with Homebrew installed using ZSH:
+brew install asdf
+
+# Add asdf's shims directory to your shell configuration:
+echo 'export PATH="\$\{ASDF_DATA_DIR:-\$HOME/.asdf\}/shims:\$PATH"' >> ~/.zshrc
+
+# Reload shell configuration:
+source ~/.zshrc
+
+# Install the Node.js plugin:
+asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
+
+# Download and install Node.js:
+asdf install nodejs ${props.release.version}
+
+# Set global Node.js version:
+asdf set -u nodejs ${props.release.version}
diff --git a/apps/site/util/download/constants.json b/apps/site/util/download/constants.json
@@ -187,6 +187,16 @@
       },
       "url": "https://github.com/tj/n",
       "info": "layouts.download.codeBox.platformInfo.n"
+    },
+    {
+      "id": "ASDF",
+      "icon": "ASDF",
+      "name": "asdf",
+      "compatibility": {
+        "os": ["MAC", "LINUX"]
+      },
+      "url": "https://asdf-vm.com/guide/getting-started.html",
+      "info": "layouts.download.codeBox.platformInfo.asdf"
     }
   ],
   "packageManagers": [
diff --git a/packages/i18n/src/locales/en.json b/packages/i18n/src/locales/en.json
@@ -388,7 +388,8 @@
           "choco": "Chocolatey is a package manager for Windows.",
           "docker": "Docker is a containerization platform.",
           "n": "\"n\" is a cross-platform Node.js version manager.",
-          "volta": "\"Volta\" is a cross-platform Node.js version manager."
+          "volta": "\"Volta\" is a cross-platform Node.js version manager.",
+          "asdf": "\"asdf\" is a cross-platform version manager that supports multiple languages."
         }
       }
     },
diff --git a/packages/ui-components/src/Icons/InstallationMethod/ASDF.tsx b/packages/ui-components/src/Icons/InstallationMethod/ASDF.tsx
@@ -0,0 +1,12 @@
+import type { FC, SVGProps } from 'react';
+
+const ASDF: FC<SVGProps<SVGSVGElement>> = props => (
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 683.2 250" {...props}>
+    <path
+      d="M60.7 248.1c-11 0-20.88-1.94-29.65-5.84-8.77-3.89-15.67-9.7-20.7-17.43-5.03-7.73-7.55-17.35-7.55-28.87 0-9.65 1.79-17.74 5.37-24.28 3.58-6.54 8.46-11.77 14.63-15.72 6.17-3.94 13.18-6.95 21.01-9.03 7.83-2.07 16.05-3.53 24.67-4.36 10.06-1.04 18.18-2 24.36-2.88 6.17-.88 10.68-2.28 13.54-4.2 2.85-1.92 4.28-4.75 4.28-8.48v-.78c0-4.98-1.04-9.18-3.11-12.61-2.08-3.42-5.16-6.04-9.26-7.86-4.1-1.81-9.05-2.72-14.86-2.72s-11.26.91-15.72 2.72c-4.46 1.82-8.09 4.23-10.89 7.24-2.8 3.01-4.88 6.38-6.22 10.12l-42.8-7c3.01-10.17 7.99-18.78 14.94-25.83 6.95-7.05 15.59-12.45 25.91-16.18 10.32-3.73 21.97-5.6 34.94-5.6 9.34 0 18.41 1.12 27.23 3.35s16.73 5.68 23.73 10.35 12.55 10.76 16.65 18.29c4.1 7.52 6.15 16.52 6.15 27v117.19h-44.2v-24.12h-1.56c-2.8 5.4-6.54 10.14-11.2 14.24-4.67 4.1-10.3 7.34-16.89 9.73-6.59 2.39-14.19 3.58-22.8 3.58Zm13.23-32.84c7.37 0 13.82-1.45 19.38-4.36 5.55-2.9 9.88-6.85 12.99-11.83 3.11-4.98 4.67-10.53 4.67-16.65v-18.83c-1.35 1.04-3.42 1.97-6.22 2.8-2.8.83-5.91 1.56-9.34 2.18-3.42.62-6.8 1.19-10.12 1.71-3.32.52-6.28.93-8.87 1.24-5.71.83-10.74 2.18-15.1 4.05-4.36 1.87-7.73 4.33-10.12 7.39-2.39 3.06-3.58 6.98-3.58 11.75 0 4.46 1.14 8.22 3.42 11.28 2.28 3.06 5.39 5.37 9.34 6.93 3.94 1.56 8.45 2.33 13.54 2.33ZM266.28 248.1c-14.01 0-26.4-2-37.19-5.99s-19.61-9.8-26.46-17.43c-6.85-7.63-11.26-16.83-13.23-27.62l43.42-7.47c2.28 8.09 6.28 14.16 11.98 18.21 5.7 4.05 13.33 6.07 22.88 6.07 8.92 0 15.95-1.68 21.09-5.06 5.14-3.37 7.7-7.65 7.7-12.84 0-4.56-1.84-8.3-5.52-11.21-3.68-2.9-9.31-5.14-16.89-6.69l-30.03-6.22c-16.81-3.42-29.36-9.26-37.66-17.51-8.3-8.25-12.45-18.85-12.45-31.82 0-11.21 3.06-20.83 9.18-28.87 6.12-8.04 14.63-14.24 25.52-18.6 10.89-4.36 23.71-6.54 38.44-6.54 13.69 0 25.57 1.89 35.64 5.68 10.06 3.79 18.21 9.16 24.43 16.11 6.23 6.95 10.37 15.15 12.45 24.59l-41.4 7.31c-1.77-5.91-5.16-10.76-10.19-14.55-5.03-3.79-11.8-5.68-20.31-5.68-7.68 0-14.11 1.61-19.3 4.82-5.19 3.22-7.78 7.52-7.78 12.92 0 4.36 1.68 8.04 5.06 11.05 3.37 3.01 9.16 5.34 17.35 7l31.28 6.22c16.81 3.42 29.31 9 37.51 16.73s12.29 17.82 12.29 30.27c0 11.41-3.32 21.4-9.96 29.96-6.64 8.56-15.8 15.23-27.47 20s-25.13 7.16-40.38 7.16ZM439.17 247.63c-13.28 0-25.29-3.45-36.03-10.35-10.74-6.9-19.22-17.01-25.44-30.35-6.23-13.33-9.34-29.65-9.34-48.94s3.22-36.36 9.65-49.64c6.43-13.28 14.99-23.24 25.68-29.88 10.68-6.64 22.46-9.96 35.33-9.96 9.86 0 18.05 1.66 24.59 4.98 6.54 3.32 11.83 7.42 15.87 12.29 4.05 4.88 7.05 9.6 9.03 14.16h1.56V12.79h46.69v231.88h-45.91v-27.86h-2.33c-2.08 4.67-5.16 9.36-9.26 14.08-4.1 4.72-9.42 8.69-15.95 11.91-6.54 3.21-14.58 4.82-24.12 4.82Zm14.48-37.5c7.88 0 14.63-2.18 20.23-6.54 5.6-4.36 9.86-10.45 12.76-18.29 2.9-7.83 4.36-16.99 4.36-27.47s-1.43-19.74-4.28-27.47c-2.85-7.73-7.08-13.75-12.68-18.05-5.6-4.3-12.4-6.46-20.39-6.46s-15.07 2.23-20.62 6.69c-5.55 4.46-9.73 10.58-12.53 18.36-2.8 7.78-4.2 16.76-4.2 26.92s1.43 19.2 4.28 27.08c2.85 7.89 7.05 14.06 12.61 18.52 5.55 4.46 12.37 6.69 20.46 6.69ZM673.39 70.69v35.64H559.78V70.69h113.61Zm-82.95 173.98V57.3c0-12.35 2.46-22.62 7.39-30.81 4.93-8.19 11.64-14.34 20.15-18.44 8.51-4.1 18.16-6.15 28.95-6.15 7.37 0 14.08.6 20.15 1.79 6.07 1.19 10.5 2.21 13.31 3.03l-8.4 35.17c-1.97-.52-4.28-1.04-6.93-1.56-2.65-.52-5.52-.78-8.64-.78-7.06 0-12.06 1.69-15.02 5.06-2.96 3.37-4.43 8.12-4.43 14.24v185.82h-46.53Z"
+      fill="#a74e9e"
+    />
+  </svg>
+);
+
+export default ASDF;
diff --git a/packages/ui-components/src/Icons/InstallationMethod/index.ts b/packages/ui-components/src/Icons/InstallationMethod/index.ts
@@ -1,3 +1,4 @@
+import ASDF from '#ui/Icons/InstallationMethod/ASDF';
 import Choco from '#ui/Icons/InstallationMethod/Choco';
 import Docker from '#ui/Icons/InstallationMethod/Docker';
 import FNM from '#ui/Icons/InstallationMethod/FNM';
@@ -6,4 +7,4 @@ import N from '#ui/Icons/InstallationMethod/N';
 import NVM from '#ui/Icons/InstallationMethod/NVM';
 import Volta from '#ui/Icons/InstallationMethod/Volta';
 
-export { Choco, Docker, FNM, Homebrew, N, NVM, Volta };
+export { ASDF, Choco, Docker, FNM, Homebrew, N, NVM, Volta };

Original file line number	Diff line number	Diff line change
`@@ -388,7 +388,8 @@`
`388`	`388`	`"choco": "Chocolatey is a package manager for Windows.",`
`389`	`389`	`"docker": "Docker is a containerization platform.",`
`390`	`390`	`"n": "\"n\" is a cross-platform Node.js version manager.",`
`391`		`- "volta": "\"Volta\" is a cross-platform Node.js version manager."`
	`391`	`+ "volta": "\"Volta\" is a cross-platform Node.js version manager.",`
	`392`	`+ "asdf": "\"asdf\" is a cross-platform version manager that supports multiple languages."`
`392`	`393`	`}`
`393`	`394`	`}`
`394`	`395`	`},`