diff --git a/website/.vitepress/components/InstallationMethod.vue b/website/.vitepress/components/InstallationMethod.vue
new file mode 100644
index 0000000000..59d440653e
--- /dev/null
+++ b/website/.vitepress/components/InstallationMethod.vue
@@ -0,0 +1,226 @@
+<script setup lang="ts">
+defineProps<{
+  platforms: string;
+  platformLabel: string;
+}>();
+</script>
+
+<template>
+  <div class="install-method" :data-platforms="platforms">
+    <slot name="heading" />
+    <div class="install-meta">
+      <p class="install-platforms">{{ platformLabel }}</p>
+      <div v-if="$slots.links" class="install-links">
+        <slot name="links" />
+      </div>
+    </div>
+    <slot />
+  </div>
+</template>
+
+<style scoped>
+.install-method {
+  position: relative;
+  margin: 16px 0;
+  padding: 20px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  background: var(--vp-c-bg);
+}
+
+.install-method :deep(h3) {
+  position: relative;
+  margin: 0 0 4px;
+  padding: 0 0 0 30px;
+  font-size: 18px;
+  line-height: 26px;
+}
+
+/* Decorative CSS masks keep logos out of heading names and the page outline. */
+.install-method :deep(h3::before) {
+  position: absolute;
+  top: 3px;
+  left: 0;
+  width: 20px;
+  height: 20px;
+  background-color: var(--install-icon-color, var(--vp-c-text-2));
+  content: '';
+  -webkit-mask: var(--install-icon, url('../theme/icons/install/package.svg'))
+    center / contain no-repeat;
+  mask: var(--install-icon, url('../theme/icons/install/package.svg')) center /
+    contain no-repeat;
+}
+
+.install-method :deep(#homebrew) {
+  --install-icon: url('../theme/icons/install/homebrew.svg');
+  --install-icon-color: #fbb040;
+}
+
+.install-method :deep(#apk) {
+  --install-icon: url('../theme/icons/install/alpinelinux.svg');
+  --install-icon-color: #0d597f;
+}
+
+.install-method :deep(#snap) {
+  --install-icon: url('../theme/icons/install/snapcraft.svg');
+  --install-icon-color: #e95420;
+}
+
+.install-method :deep(#npm) {
+  --install-icon: url('../theme/icons/install/npm.svg');
+  --install-icon-color: #cb3837;
+}
+
+.install-method :deep(#mise) {
+  --install-icon: url('../theme/icons/install/mise.svg');
+  --install-icon-color: var(--vp-c-text-1);
+}
+
+.install-method :deep(#pip) {
+  --install-icon: url('../theme/icons/install/python.svg');
+  --install-icon-color: #3776ab;
+}
+
+.install-method :deep(#chocolatey) {
+  --install-icon: url('../theme/icons/install/chocolatey.svg');
+  --install-icon-color: #80b5e3;
+}
+
+.install-method :deep(#arch) {
+  --install-icon: url('../theme/icons/install/archlinux.svg');
+  --install-icon-color: #1793d1;
+}
+
+.install-method :deep(#fedora-community) {
+  --install-icon: url('../theme/icons/install/fedora.svg');
+  --install-icon-color: #51a2da;
+}
+
+.install-method :deep(#freebsd) {
+  --install-icon: url('../theme/icons/install/freebsd.svg');
+  --install-icon-color: #ab2b28;
+}
+
+.install-method :deep(#nix) {
+  --install-icon: url('../theme/icons/install/nixos.svg');
+  --install-icon-color: #5277c3;
+}
+
+.install-method :deep(h3 a:not(.header-anchor)) {
+  color: var(--vp-c-text-1);
+  text-decoration: none;
+}
+
+.install-method :deep(h3 a:hover) {
+  color: var(--vp-c-brand-1);
+}
+
+.install-method :deep(.install-meta) {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px 16px;
+  margin: 4px 0 12px;
+}
+
+.install-method :deep(.install-platforms) {
+  margin: 0;
+  color: var(--vp-c-text-2);
+  font-size: 12px;
+  line-height: 20px;
+  font-weight: 500;
+}
+
+.install-method :deep(.install-links p) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 0;
+}
+
+.install-method :deep(.install-links a) {
+  padding: 3px 9px;
+  border: 1px solid transparent;
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--vp-c-brand-1) 12%, transparent);
+  color: color-mix(in srgb, var(--vp-c-brand-1) 45%, var(--vp-c-text-1));
+  font-size: 12px;
+  font-weight: 500;
+  line-height: 20px;
+  text-decoration: none;
+}
+
+.install-method :deep(.install-links a:hover) {
+  border-color: var(--vp-c-brand-1);
+}
+
+.install-method :deep(.install-links a:focus-visible) {
+  outline: 2px solid var(--vp-c-brand-1);
+  outline-offset: 2px;
+}
+
+.install-method :deep(p) {
+  margin: 12px 0;
+  font-size: 14px;
+  line-height: 22px;
+}
+
+.install-method > :deep(:last-child) {
+  margin-bottom: 0;
+}
+
+.install-method :deep(div[class*='language-']) {
+  margin: 12px 0;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+}
+
+/* Compact commands leave no room for the overlaid language label. */
+.install-method :deep(div[class*='language-'] > span.lang) {
+  display: none;
+}
+
+.install-method :deep(div[class*='language-'] pre) {
+  padding: 14px 0;
+}
+
+.install-method :deep(div[class*='language-'] code) {
+  padding: 0 18px;
+  font-size: 13px;
+  line-height: 22px;
+}
+
+/* Keep the 40px copy control inside the compact, 50px single-line block. */
+.install-method :deep(div[class*='language-'] > button.copy) {
+  top: 5px;
+  right: 6px;
+}
+
+.install-method :deep(.vp-code-group) {
+  margin-top: 16px;
+}
+
+.install-method :deep(.vp-code-group .tabs) {
+  margin: 0;
+  border-radius: 8px 8px 0 0;
+}
+
+.install-method :deep(.vp-code-group div[class*='language-']) {
+  margin: 0;
+  border-radius: 0 0 8px 8px;
+}
+
+@media (max-width: 639px) {
+  .install-method {
+    padding: 16px;
+  }
+}
+
+@media print {
+  .install-method {
+    display: block !important;
+    break-inside: avoid;
+  }
+}
+</style>
diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
new file mode 100644
index 0000000000..6b114bf1dd
--- /dev/null
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -0,0 +1,325 @@
+<script setup lang="ts">
+import { nextTick, onMounted, onUnmounted, ref } from 'vue';
+
+const platforms = [
+  { id: 'all', label: 'All' },
+  { id: 'macos', label: 'macOS' },
+  { id: 'linux', label: 'Linux' },
+  { id: 'windows', label: 'Windows' }
+];
+const selected = ref('all');
+const methods = ref<HTMLElement>();
+const count = ref<number>();
+
+async function selectPlatform(platform: string) {
+  selected.value = platform;
+  await nextTick();
+  count.value = Array.from(
+    methods.value?.querySelectorAll<HTMLElement>('.install-method') ?? []
+  ).filter((method) => method.offsetHeight > 0).length;
+}
+
+async function revealLinkedMethod() {
+  if (!location.hash || selected.value === 'all') return;
+  let id: string;
+  try {
+    id = decodeURIComponent(location.hash.slice(1));
+  } catch {
+    return;
+  }
+  const target = document.getElementById(id);
+  const method = target?.closest<HTMLElement>('.install-method');
+  if (!method || !methods.value?.contains(method) || method.offsetHeight > 0) {
+    return;
+  }
+  await selectPlatform('all');
+  target?.scrollIntoView();
+}
+
+function revealCurrentLink(event: MouseEvent) {
+  if (
+    event.button !== 0 ||
+    event.metaKey ||
+    event.ctrlKey ||
+    event.shiftKey ||
+    event.altKey
+  ) {
+    return;
+  }
+  const link =
+    event.target instanceof Element
+      ? event.target.closest<HTMLAnchorElement>('a[href]')
+      : null;
+  // Clicking the current anchor again does not emit a hashchange event.
+  if (link?.href === location.href) void revealLinkedMethod();
+}
+
+onMounted(() => {
+  window.addEventListener('click', revealCurrentLink, true);
+  window.addEventListener('hashchange', revealLinkedMethod);
+  window.addEventListener('popstate', revealLinkedMethod);
+});
+onUnmounted(() => {
+  window.removeEventListener('click', revealCurrentLink, true);
+  window.removeEventListener('hashchange', revealLinkedMethod);
+  window.removeEventListener('popstate', revealLinkedMethod);
+});
+</script>
+
+<template>
+  <div ref="methods" class="installation-methods" :data-platform="selected">
+    <div class="install-picker">
+      <span id="install-platform-label" class="install-picker-label">
+        Choose your system
+      </span>
+      <div
+        class="install-platform-buttons"
+        role="group"
+        aria-labelledby="install-platform-label"
+      >
+        <button
+          v-for="platform in platforms"
+          :key="platform.id"
+          type="button"
+          :aria-pressed="selected === platform.id"
+          @click="selectPlatform(platform.id)"
+        >
+          <svg
+            class="install-platform-icon"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="1.7"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            aria-hidden="true"
+          >
+            <template v-if="platform.id === 'all'">
+              <rect x="3" y="4" width="18" height="13" rx="2" />
+              <path d="M8 21h8m-4-4v4" />
+            </template>
+            <path
+              v-else-if="platform.id === 'macos'"
+              d="M9 9V6a3 3 0 1 0-3 3h12a3 3 0 1 0-3-3v12a3 3 0 1 0 3-3H6a3 3 0 1 0 3 3V9"
+            />
+            <template v-else-if="platform.id === 'linux'">
+              <rect x="3" y="4" width="18" height="16" rx="2" />
+              <path d="m7 9 3 3-3 3m6 0h4" />
+            </template>
+            <template v-else>
+              <rect x="3" y="3" width="18" height="18" rx="1" />
+              <path d="M12 3v18M3 12h18" />
+            </template>
+          </svg>
+          {{ platform.label }}
+        </button>
+      </div>
+      <span class="install-sr-only" role="status">
+        {{ count === undefined ? '' : `${count} installation methods shown.` }}
+      </span>
+    </div>
+    <slot />
+  </div>
+</template>
+
+<style scoped>
+:global(.installation-page .installation-shortcuts) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 20px;
+  margin: 12px 0 24px;
+}
+
+:global(.installation-page .installation-shortcuts a) {
+  padding: 4px 0;
+  color: color-mix(in srgb, var(--vp-c-brand-1) 45%, var(--vp-c-text-1));
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 20px;
+  text-decoration: underline;
+  text-decoration-color: color-mix(in srgb, currentColor 55%, transparent);
+  text-underline-offset: 4px;
+}
+
+:global(.installation-page .installation-shortcuts a:hover) {
+  color: var(--vp-c-text-1);
+  text-decoration-color: currentColor;
+}
+
+:global(.installation-page .installation-shortcuts a:focus-visible) {
+  outline: 2px solid var(--vp-c-brand-1);
+  outline-offset: 3px;
+}
+
+.install-picker {
+  margin: 24px 0 0;
+}
+
+.install-picker-label {
+  display: block;
+  margin-bottom: 8px;
+  color: var(--vp-c-text-2);
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.install-platform-buttons {
+  display: flex;
+  gap: 3px;
+  width: fit-content;
+  max-width: 100%;
+  padding: 4px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  background: var(--vp-c-bg-soft);
+}
+
+.install-platform-buttons button {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  min-height: 40px;
+  padding: 8px 16px;
+  border-radius: 8px;
+  color: var(--vp-c-text-2);
+  font-size: 14px;
+  font-weight: 600;
+  transition:
+    background-color 0.15s,
+    color 0.15s;
+}
+
+.install-platform-buttons button:hover {
+  color: var(--vp-c-text-1);
+  background: var(--vp-c-default-soft);
+}
+
+.install-platform-buttons button[aria-pressed='true'] {
+  color: color-mix(in srgb, var(--vp-c-brand-1) 40%, var(--vp-c-text-1));
+  background: color-mix(in srgb, var(--vp-c-brand-1) 18%, var(--vp-c-bg));
+  box-shadow: inset 0 0 0 1px
+    color-mix(in srgb, var(--vp-c-brand-1) 40%, transparent);
+}
+
+.install-platform-icon {
+  width: 16px;
+  height: 16px;
+  flex-shrink: 0;
+}
+
+.install-platform-buttons button:focus-visible {
+  outline: 2px solid var(--vp-c-brand-1);
+  outline-offset: 2px;
+}
+
+.install-sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+
+.installation-methods :deep(.installation-shortcuts + h2) {
+  margin-top: 24px;
+  padding-top: 0;
+  border-top: 0;
+}
+
+:global(.installation-page div[class*='language-'] pre) {
+  overflow-x: auto;
+  overflow-y: hidden;
+  scrollbar-width: thin;
+  scrollbar-color: transparent transparent;
+}
+
+:global(.installation-page div[class*='language-']:hover pre),
+:global(.installation-page div[class*='language-']:focus-within pre) {
+  scrollbar-color: var(--vp-c-text-3) transparent;
+}
+
+/* Fallback for browsers without scrollbar-color support. */
+:global(.installation-page div[class*='language-'] pre::-webkit-scrollbar) {
+  height: 6px;
+}
+
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-track
+),
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+) {
+  background: transparent;
+}
+
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+) {
+  border-radius: 3px;
+}
+
+:global(
+  .installation-page div[class*='language-']:hover pre::-webkit-scrollbar-thumb
+),
+:global(
+  .installation-page
+    div[class*='language-']:focus-within
+    pre::-webkit-scrollbar-thumb
+) {
+  background: var(--vp-c-text-3);
+}
+
+.installation-methods :deep(.install-hosting) {
+  margin: 24px 0 40px;
+  color: var(--vp-c-text-2);
+  font-size: 13px;
+  line-height: 22px;
+}
+
+.installation-methods[data-platform='macos']
+  :deep(.install-method:not([data-platforms~='macos'])),
+.installation-methods[data-platform='linux']
+  :deep(.install-method:not([data-platforms~='linux'])),
+.installation-methods[data-platform='windows']
+  :deep(.install-method:not([data-platforms~='windows'])) {
+  display: none;
+}
+
+@media (max-width: 639px) {
+  .install-platform-buttons {
+    width: 100%;
+  }
+
+  .install-platform-buttons button {
+    flex: 1;
+    padding: 8px 10px;
+    font-size: 13px;
+  }
+}
+
+@media (max-width: 379px) {
+  .install-platform-icon {
+    display: none;
+  }
+}
+
+@media (hover: none), (forced-colors: active) {
+  :global(.installation-page div[class*='language-'] pre) {
+    scrollbar-color: auto;
+  }
+
+  :global(
+    .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+  ) {
+    background: var(--vp-c-text-3);
+  }
+}
+
+@media print {
+  .install-picker {
+    display: none;
+  }
+}
+</style>
diff --git a/website/.vitepress/theme/icons/install/alpinelinux.svg b/website/.vitepress/theme/icons/install/alpinelinux.svg
new file mode 100644
index 0000000000..fd8efd6544
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/alpinelinux.svg
@@ -0,0 +1,4 @@
+<!-- Alpine Linux: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://alpinelinux.org
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Alpine Linux</title><path d="M5.998 1.607L0 12l5.998 10.393h12.004L24 12 18.002 1.607H5.998zM9.965 7.12L12.66 9.9l1.598 1.595.002-.002 2.41 2.363c-.2.14-.386.252-.563.344a3.756 3.756 0 01-.496.217 2.702 2.702 0 01-.425.111c-.131.023-.25.034-.358.034-.13 0-.242-.014-.338-.034a1.317 1.317 0 01-.24-.072.95.95 0 01-.2-.113l-1.062-1.092-3.039-3.041-1.1 1.053-3.07 3.072a.974.974 0 01-.2.111 1.274 1.274 0 01-.237.073c-.096.02-.209.033-.338.033-.108 0-.227-.009-.358-.031a2.7 2.7 0 01-.425-.114 3.748 3.748 0 01-.496-.217 5.228 5.228 0 01-.563-.343l6.803-6.727zm4.72.785l4.579 4.598 1.382 1.353a5.24 5.24 0 01-.564.344 3.73 3.73 0 01-.494.217 2.697 2.697 0 01-.426.111c-.13.023-.251.034-.36.034-.129 0-.241-.014-.337-.034a1.285 1.285 0 01-.385-.146c-.033-.02-.05-.036-.053-.04l-1.232-1.218-2.111-2.111-.334.334L12.79 9.8l1.896-1.897zm-5.966 4.12v2.529a2.128 2.128 0 01-.356-.035 2.765 2.765 0 01-.422-.116 3.708 3.708 0 01-.488-.214 5.217 5.217 0 01-.555-.34l1.82-1.825Z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/archlinux.svg b/website/.vitepress/theme/icons/install/archlinux.svg
new file mode 100644
index 0000000000..06d2f212a2
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/archlinux.svg
@@ -0,0 +1,4 @@
+<!-- Arch Linux: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://www.archlinux.org/art
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Arch Linux</title><path d="M11.39.605C10.376 3.092 9.764 4.72 8.635 7.132c.693.734 1.543 1.589 2.923 2.554-1.484-.61-2.496-1.224-3.252-1.86C6.86 10.842 4.596 15.138 0 23.395c3.612-2.085 6.412-3.37 9.021-3.862a6.61 6.61 0 01-.171-1.547l.003-.115c.058-2.315 1.261-4.095 2.687-3.973 1.426.12 2.534 2.096 2.478 4.409a6.52 6.52 0 01-.146 1.243c2.58.505 5.352 1.787 8.914 3.844-.702-1.293-1.33-2.459-1.929-3.57-.943-.73-1.926-1.682-3.933-2.713 1.38.359 2.367.772 3.137 1.234-6.09-11.334-6.582-12.84-8.67-17.74zM22.898 21.36v-.623h-.234v-.084h.562v.084h-.234v.623h.331v-.707h.142l.167.5.034.107a2.26 2.26 0 01.038-.114l.17-.493H24v.707h-.091v-.593l-.206.593h-.084l-.205-.602v.602h-.091"/></svg>
diff --git a/website/.vitepress/theme/icons/install/chocolatey.svg b/website/.vitepress/theme/icons/install/chocolatey.svg
new file mode 100644
index 0000000000..831b0ba8d9
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/chocolatey.svg
@@ -0,0 +1,4 @@
+<!-- Chocolatey: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://chocolatey.org/media-kit
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Chocolatey</title><path d="M0 1.249l1.439 3.18L0 6.926l1.439 2.5L0 11.923l1.439 2.424L0 16.845l1.439 2.5L0 22.75l2.8-.91c6.3.01 12.696.006 18.096 0l3.104.91-2.044-3.635 1.136-1.892-2.196-2.272-.004-.017V2.005c-6.551-.001-12.243 0-18.091 0zm19.688 1.968v7.03l-.23-.898-1.438-4.39-3.56.605-1.89-2.343zm-11.695.004h4.563L9.539 4.428zm2.86 3.68a3.903 3.903 0 0 1 1.64.254c1.968.757 1.286 2.8.15 4.012-.378.378-1.21.227-.605-.908.228-.454.454-1.363-.227-1.59-1.515-.53-3.255.682-3.634 2.271-.378 1.363.606 2.801 2.347 2.423 1.439-.303 2.802-1.288 3.332-1.742.53-.455.907.38.301 1.288-.68.908-1.74 1.968-2.65 2.574-3.558 2.423-6.662-.758-5.375-4.392.677-1.845 2.454-4.041 4.72-4.19zm6.527 2.031a.66.66 0 0 1 .454.182c.324.326.204.972-.268 1.445-.473.474-1.121.593-1.446.268-.325-.326-.205-.972.267-1.445.292-.292.666-.461.993-.45zm-.42 3.233a.66.66 0 0 1 .454.182c.325.325.206.973-.268 1.446-.473.473-1.12.592-1.445.268-.324-.326-.205-.972.268-1.445.291-.292.664-.462.99-.451Z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/fedora.svg b/website/.vitepress/theme/icons/install/fedora.svg
new file mode 100644
index 0000000000..98a1764feb
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/fedora.svg
@@ -0,0 +1,5 @@
+<!-- Fedora: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://docs.fedoraproject.org/en-US/project/brand/
+Icon license: custom — https://docs.fedoraproject.org/en-US/project/brand/
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Fedora</title><path d="M12.001 0C5.376 0 .008 5.369.004 11.992H.002v9.287h.002A2.726 2.726 0 0 0 2.73 24h9.275c6.626-.004 11.993-5.372 11.993-11.997C23.998 5.375 18.628 0 12 0zm2.431 4.94c2.015 0 3.917 1.543 3.917 3.671 0 .197.001.395-.03.619a1.002 1.002 0 0 1-1.137.893 1.002 1.002 0 0 1-.842-1.175 2.61 2.61 0 0 0 .013-.337c0-1.207-.987-1.672-1.92-1.672-.934 0-1.775.784-1.777 1.672.016 1.027 0 2.046 0 3.07l1.732-.012c1.352-.028 1.368 2.009.016 1.998l-1.748.013c-.004.826.006.677.002 1.093 0 0 .015 1.01-.016 1.776-.209 2.25-2.124 4.046-4.424 4.046-2.438 0-4.448-1.993-4.448-4.437.073-2.515 2.078-4.492 4.603-4.469l1.409-.01v1.996l-1.409.013h-.007c-1.388.04-2.577.984-2.6 2.47a2.438 2.438 0 0 0 2.452 2.439c1.356 0 2.441-.987 2.441-2.437l-.001-7.557c0-.14.005-.252.02-.407.23-1.848 1.883-3.256 3.754-3.256z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/freebsd.svg b/website/.vitepress/theme/icons/install/freebsd.svg
new file mode 100644
index 0000000000..a446f3c151
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/freebsd.svg
@@ -0,0 +1,4 @@
+<!-- FreeBSD: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://www.freebsdfoundation.org/about/project/
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>FreeBSD</title><path d="M23.682 2.406c-.001-.149-.097-.187-.24-.189h-.25v.659h.108v-.282h.102l.17.282h.122l-.184-.29c.102-.012.175-.065.172-.18zm-.382.096v-.193h.13c.06-.002.145.011.143.089.005.09-.08.107-.153.103h-.12zM21.851 1.49c1.172 1.171-2.077 6.319-2.626 6.869-.549.548-1.944.044-3.115-1.128-1.172-1.171-1.676-2.566-1.127-3.115.549-.55 5.697-3.798 6.868-2.626zM1.652 6.61C.626 4.818-.544 2.215.276 1.395c.81-.81 3.355.319 5.144 1.334A11.003 11.003 0 0 0 1.652 6.61zm18.95.418a10.584 10.584 0 0 1 1.368 5.218c0 5.874-4.762 10.636-10.637 10.636C5.459 22.882.697 18.12.697 12.246.697 6.371 5.459 1.61 11.333 1.61c1.771 0 3.441.433 4.909 1.199-.361.201-.69.398-.969.574-.428-.077-.778-.017-.998.202-.402.402-.269 1.245.263 2.2.273.539.701 1.124 1.25 1.674.103.104.208.202.315.297 1.519 1.446 3.205 2.111 3.829 1.486.267-.267.297-.728.132-1.287.167-.27.35-.584.538-.927zm2.814-5.088c-.322 0-.584.266-.584.595s.261.595.584.595c.323 0 .584-.266.584-.595s-.261-.595-.584-.595zm0 1.087c-.252 0-.457-.22-.457-.492s.204-.492.457-.492c.252 0 .457.22.457.492s-.204.492-.457.492z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/homebrew.svg b/website/.vitepress/theme/icons/install/homebrew.svg
new file mode 100644
index 0000000000..d1abcb65a9
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/homebrew.svg
@@ -0,0 +1,4 @@
+<!-- Homebrew: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://github.com/Homebrew/brew.sh/blob/2e576aaca83e62dda41a188597bb4bd20e75e385/assets/img/homebrew.svg
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Homebrew</title><path d="M7.938 0a.214.214 0 0 0-.206.156c-.316 1.104.179 2.15.838 2.935.153.181.313.347.476.501a2.039 2.039 0 0 0-.665.02c-1.184.233-2.193.985-2.74 2.532a3.893 3.893 0 0 0-.2 1.466 1.565 1.565 0 0 0-1.156 1.504 1.59 1.59 0 0 0 1.227 1.541l.026 12.046c0 .195.1.377.264.482a.214.214 0 0 0 .008.005c.537.31 2.047.812 5.21.812 3.238 0 4.7-.678 5.181-1.04a.214.214 0 0 0 .008-.007.571.571 0 0 0 .206-.439c.002-.344.002-1.136.002-1.604a.143.143 0 0 1 .147-.144c.397.006.869.006 1.318.005a1.826 1.826 0 0 0 1.832-1.825v-5.804a1.826 1.826 0 0 0-1.825-1.826H16.56a.14.14 0 0 1-.143-.144V10.6h.007v-.001a1.573 1.573 0 0 0 1.356-1.556c0-.816-.627-1.489-1.424-1.563-.025-1.438-.437-2.126-.736-2.58a.214.214 0 0 0-.005-.007c-.364-.51-1.193-1.282-2.275-1.316-.503-.016-.842.124-1.125.254-.217.1-.42.177-.67.22.002-1.286.945-1.981.945-1.981a.214.214 0 0 0 .05-.298s-.087-.122-.21-.26c-.121-.136-.269-.294-.47-.378a.214.214 0 0 0-.079-.017.214.214 0 0 0-.145.055 4.308 4.308 0 0 0-.875 1.101 3.42 3.42 0 0 0-.133.273 3.497 3.497 0 0 0-.381-.846C9.794.978 9.063.436 8.017.016A.214.214 0 0 0 7.939 0zm.156.524c.85.378 1.43.83 1.79 1.403.274.438.426.962.484 1.584a3.07 3.07 0 0 0-.012.462 6.897 6.897 0 0 1-.168-.052 5.487 5.487 0 0 1-1.29-1.106c-.551-.657-.935-1.46-.804-2.291zM11.8 1.618c.07.054.141.101.212.18.034.039.032.04.058.073-.332.308-1.07 1.144-.952 2.453a.214.214 0 0 0 .222.195c.469-.017.782-.172 1.056-.299.273-.126.508-.228.931-.214.875.027 1.639.715 1.939 1.134.295.449.65 1 .663 2.36a1.66 1.66 0 0 0-.41.142 1.938 1.938 0 0 0-1.77-1.16 1.94 1.94 0 0 0-1.87 1.448 1.783 1.783 0 0 0-1.356-.64c-.484 0-.91.205-1.233.517a1.873 1.873 0 0 0-1.85-1.625c-.649 0-1.218.335-1.552.84a3.1 3.1 0 0 1 .157-.735c.51-1.437 1.355-2.045 2.42-2.254.367-.073.664-.011.99.095.325.106.671.262 1.094.342a.214.214 0 0 0 .252-.245c-.112-.67.073-1.266.336-1.744a3.71 3.71 0 0 1 .663-.863zM7.44 6.611a1.442 1.442 0 0 1 1.363 1.925.214.214 0 0 0 .168.283h.005a.214.214 0 0 0 .238-.146 1.373 1.373 0 0 1 2.613-.01.214.214 0 0 0 .417-.09 1.509 1.509 0 0 1 1.504-1.664c.678 0 1.249.445 1.442 1.056a.214.214 0 0 0 .259.143l.15-.04a.214.214 0 0 0 .051-.02 1.139 1.139 0 0 1 1.702.995 1.14 1.14 0 0 1-.985 1.131.214.214 0 0 0-.001 0 2.215 2.215 0 0 0-.485.126 10.65 10.65 0 0 1-1.176.365.214.214 0 0 0-.162.186 1.276 1.276 0 0 1-.146.478 2.07 2.07 0 0 0-.239 1.111l.001.151a.438.438 0 0 1-.16.36.665.665 0 0 1-.43.14.586.586 0 0 1-.588-.59.803.803 0 0 0-.38-.681.214.214 0 0 0-.002-.002c-.24-.145-.43-.37-.532-.636a.214.214 0 0 0-.207-.138 19.469 19.469 0 0 1-5.37-.6l-.003-.002a9.007 9.007 0 0 0-.838-.194h.003a1.16 1.16 0 0 1-.937-1.134c0-.619.488-1.118 1.101-1.14a.214.214 0 0 0 .204-.176 1.443 1.443 0 0 1 1.42-1.187zm8.549 4.106v.455c0 .314.259.573.572.573h1.329a1.397 1.397 0 0 1 1.397 1.397v5.804a1.396 1.396 0 0 1-1.402 1.396.214.214 0 0 0-.002 0c-.448.002-.918 0-1.31-.005a.573.573 0 0 0-.584.573c0 .468 0 1.262-.002 1.603a.214.214 0 0 0 0 .001c0 .042-.019.08-.05.107-.346.26-1.75.95-4.915.95-3.107 0-4.587-.52-4.99-.752a.143.143 0 0 1-.065-.118l-.025-11.955c.145.033.288.07.431.11a.214.214 0 0 0 .003 0c.115.031.246.064.383.097v10.37c0 .129.069.247.18.31.453.217 1.767.732 4.071.732 2.32 0 3.595-.626 4.022-.884a.357.357 0 0 0 .164-.3l.001-10.21c.267-.075.531-.158.792-.254zm-7.99.894a.493.493 0 0 1 .494.493v8.578a.493.493 0 0 1-.493.493.493.493 0 0 1-.494-.493v-8.578A.493.493 0 0 1 8 11.611zm8.652 1.14a.663.663 0 0 0-.662.662v5.208a.663.663 0 0 0 .662.662h1.14a.663.663 0 0 0 .662-.662v-5.209a.663.663 0 0 0-.662-.662zm0 .428h1.14a.233.233 0 0 1 .233.233v5.21a.233.233 0 0 1-.233.232h-1.14a.233.233 0 0 1-.233-.233v-5.209a.233.233 0 0 1 .233-.233z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/mise.svg b/website/.vitepress/theme/icons/install/mise.svg
new file mode 100644
index 0000000000..cd15850724
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/mise.svg
@@ -0,0 +1,31 @@
+<!-- Source: https://mise.jdx.dev/favicon.svg; light paths used as a CSS mask.
+MIT License
+
+Copyright (c) 2025 Jeff Dickey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="50 35 205 230">
+<path d="M125.97,222.76c.61.93,1.73,1.51,2.91,1.51.07,0,.13,0,.2,0,.1,0,.2-.02.29-.03,1.08-.15,1.99-.81,2.5-1.8.93-1.84,3.33-6.57,4.91-9.72.53-1.06.52-2.26-.03-3.31-.55-1.05-1.54-1.74-2.72-1.89l-2.73-.35c-1.62-.21-3.45-.45-4.86-.67-1.16-.19-2.22.2-2.92,1.05-.76.93-.97,2.28-.53,3.43.41,1.09,1.33,1.83,2.52,2.02l3.52.57-3.15,6.2c-.52,1.02-.48,2.11.1,3Z"/>
+    <path d="M168.6,216.87c.16,0,.32-.01.48-.03,1.17-.16,2.49-.98,2.68-2.79.34-3.32,2.09-6.11,4.81-7.64,2.75-1.55,6.08-1.62,9.15-.19,1.05.49,2.16.42,3.06-.21.98-.68,1.54-1.92,1.44-3.16-.1-1.18-.79-2.15-1.89-2.66-4.9-2.29-10.35-2.11-14.96.51-4.61,2.61-7.57,7.19-8.13,12.56-.22,2.12,1.39,3.43,3,3.6.12.01.24.02.36.02Z"/>
+    <path d="M225.15,195.99c.39-1.04.18-2.16-.56-3.06-2.82-3.42-6.86-5.11-11.07-4.64-4.24.47-7.97,3.13-9.99,7.12-.81,1.6-.25,3.3,1.38,4.12.52.26,1.09.4,1.65.4.36,0,.72-.06,1.06-.17.83-.27,1.49-.85,1.91-1.68.97-1.91,2.64-3.12,4.6-3.31,2.01-.21,3.96.6,5.33,2.26.74.89,1.79,1.32,2.89,1.17h.11c1.21-.22,2.27-1.08,2.69-2.21Z"/>
+    <path d="M202.14,216.23c-1.12-.23-2.17.09-2.88.88-.78.88-1.04,2.21-.65,3.4.38,1.15,1.28,1.96,2.49,2.21.64.13,1.3.2,1.96.2.45,0,.9-.03,1.35-.09,3.82-.53,7.1-3.25,8.17-6.78,1.42-4.69-1.16-9.92-5.87-11.9-1.09-.46-2.23-.33-3.13.35-.97.74-1.49,2-1.34,3.21.14,1.13.85,2.04,1.95,2.51,2.05.86,2.35,2.53,1.95,3.81-.43,1.38-1.86,2.66-4,2.21Z"/>
+    <path d="M168.94,240.24c.84.44,1.84.53,2.73.25.85-.27,1.52-.84,1.94-1.65l.96-1.84s.03.02.05.02c5.18,2.46,10.77,3.71,16.43,3.71,1.75,0,3.5-.12,5.25-.36,10.4-1.44,19.87-7.18,25.98-15.75.7-.98.82-2.15.34-3.21-.51-1.12-1.62-1.92-2.82-2.03-1.11-.1-2.13.39-2.8,1.33-9.07,12.73-25.24,16.99-39.4,10.45l1.47-2.84c.82-1.59.28-3.27-1.32-4.1-1.52-.79-3.69-.48-4.67,1.41l-5.45,10.51c-.82,1.59-.28,3.28,1.32,4.1Z"/>
+    <path d="M238.75,138.24c-5.14-1.68-10.74-1.47-17.6.68l-8.59-20.6c15.54-10.11,22.39-30.44,15.92-47.45-6.75-17.75-25.63-28.66-43.92-25.42-9.84,1.75-18.95,7.17-25.08,14.88-5.69-7.61-14.02-12.93-22.95-14.62-6.36-1.21-12.78-.81-18.58,1.14-10.97,3.68-29.99,18.28-23.91,47.24-13.45-1.34-31.13,4.26-38.76,19.84-4.53,9.26-5.06,20.2-1.45,30,3.51,9.53,10.43,16.96,19.49,20.89,9.59,4.17,20.87,4.32,30.27.42,2.22,3.97,7,12.91,10.86,20.14,2.57,4.82,4.82,9.03,5.7,10.62-1.62,1.02-3.08,2.19-4.34,3.47-6.3,6.37-8.64,15.99-5.82,23.94,2.81,7.93,11.19,13.64,19.47,13.35,5.19-.21,9.93-2.61,14.46-7.32,8.75,14.26,24.58,24.01,41.44,25.49,1.39.12,2.79.18,4.19.18,2.23,0,4.46-.15,6.68-.46,14.28-1.98,27.34-10.17,35.84-22.47,6.12-8.85,9.4-18.97,9.5-29.26.02-2.17-1.78-3.49-3.54-3.51h-.01c-1.71,0-2.97,1.23-2.98,2.94-.2,20.96-15.35,40.34-35.25,45.07-19.69,4.69-41.74-5.35-51.43-23.39.81-1.11,1.64-2.32,2.67-3.89.7-1.06.63-2.05.45-2.69-.22-.8-.76-1.53-1.48-2-1.53-1.01-3.31-.66-4.3.85l-.17.26c-3.65,5.52-8.19,12.38-15.01,13.51-5.86,1-12.35-3.08-14.44-9.1-2.01-5.79.06-13,5.04-17.53,5.03-4.58,12.42-6.23,20.28-4.55.83.18,1.66.05,2.31-.37.67-.43,1.13-1.14,1.32-2,.36-1.67-.51-3.67-2.58-4.11-5.48-1.18-11.3-.88-16.41.82l-.58-1.04c31.35-34.98,78.27-52.22,88.34-55.63l1.71,4.35c-.77.32-1.68.71-2.52,1.08l-1.3.56c-20.7,8.88-40.47,20.42-58.76,34.3-1.66,1.26-1.55,3.22-.57,4.51.52.68,1.24,1.15,2.03,1.31.9.19,1.79-.03,2.57-.63,11.13-8.45,22.76-15.98,34.56-22.41,5.86-3.19,11.96-6.22,18.13-9.01l2.14-.97c5.49-2.51,11.17-5.09,17.05-5.82,5.78-.73,12.58,1,14.72,6.52,2.03,5.24-1.09,10.87-5.06,13.51-3.4,2.26-8.22,3.3-12.67,2.76.64-2.49,1.04-5.82-.33-8.43-.86-1.64-2.28-2.77-4.23-3.35-3.03-.91-5.73.05-7.42,2.63-2.14,3.27-1.93,8.03.47,10.83.74.87,1.64,1.64,2.68,2.3-3.2,4.93-8.15,8.36-14,9.68-6.32,1.45-13.03.16-18.38-3.54-.75-.51-1.58-.7-2.42-.55-.88.16-1.7.7-2.23,1.47-.46.67-.67,1.46-.58,2.23.1.87.57,1.61,1.35,2.15,6.9,4.76,15.51,6.45,23.64,4.63,8.03-1.79,14.73-6.67,18.88-13.76,4.99.87,10.3.02,13.63-1.08,7.58-2.51,12.97-8.92,13.74-16.32.81-7.78-3.96-14.74-11.87-17.32ZM104.93,157.68c-.13,0-.26,0-.4.03-.33.05-.65.15-.96.31-7.54,3.92-16.69,4.55-25.11,1.73-7.87-2.64-14.05-7.96-17.38-14.97-3.69-7.77-4.05-16.9-.99-25.05,2.9-7.7,8.51-13.68,15.79-16.82,4.74-2.05,12.3-3.65,19.38-2.08,1.34,5.8,3.34,12.17,7.87,15.89,2.38,1.96,5.55,2.85,8.69,2.43,2.95-.46,5.44-1.92,7.01-4.12,3.35-4.7,2.23-10.94-2.61-14.5-4.96-3.66-11.12-5.11-15.5-5.69-2.5-9.67-.96-20.8,4.06-29.11,4.33-7.17,10.82-11.85,18.77-13.52,12.2-2.58,25.08,3.15,32.13,14.26-4.2,7.38-6.36,16.92.07,21.81,1.59,1.21,4.12,1.74,6.62,1.4,2.31-.32,4.27-1.36,5.38-2.86,5.15-6.89-.21-14.38-3.41-18.86l-.09-.12c-.33-.46-.64-.9-.92-1.3,4.53-7.97,12.9-13.22,23.01-14.43,11.26-1.33,22.55,2.69,29.48,10.49,6.44,7.24,9.29,16.55,8.04,26.22-1.2,9.26-6.18,17.68-13.7,23.19l-1.28-3.41c-.72-1.91-2.58-2.35-4.06-1.81-1.54.58-2.77,2.28-2.01,4.32l8.52,19.87c-10.17,3.47-56.95,20.76-89.05,55.58-1.72-3.1-4.78-8.89-7.74-14.5-2.81-5.32-5.47-10.35-6.65-12.45-.55-.99-1.67-1.91-2.98-1.91ZM113.74,107.08c.56.93.64,1.94.25,3.08-.51,1.47-1.39,2.26-2.76,2.47-1.95.2-4.43-1.14-5.63-3.09-1.3-2.11-2.34-4.58-3.26-7.72,5.92,1.13,10.05,3.04,11.39,5.26ZM163.03,81.88c-.34.78-1.05,1.19-2.24,1.29-.36.01-.88-.12-1.32-.6-.68-.74-1.34-2.41-.69-6.18h0c.2-1.18.74-2.67,1.24-3.89,2.57,3.73,3.8,7.53,3,9.39ZM219.83,164.53c-.61-.49-1.17-1.18-1.14-2.01.02-.62.36-.97.61-1.03,0,0,.02,0,.03,0,.21,0,.39.32.44.42.31.61.33,1.49.06,2.63Z"/>
+</svg>
diff --git a/website/.vitepress/theme/icons/install/nixos.svg b/website/.vitepress/theme/icons/install/nixos.svg
new file mode 100644
index 0000000000..4a9ffc0ac5
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/nixos.svg
@@ -0,0 +1,4 @@
+<!-- NixOS: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://github.com/NixOS/nixos-homepage/tree/58cfdb770aba28b73446a1b3ee65a5cec4f0d44f/logo
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>NixOS</title><path d="M7.352 1.592l-1.364.002L5.32 2.75l1.557 2.713-3.137-.008-1.32 2.34H14.11l-1.353-2.332-3.192-.006-2.214-3.865zm6.175 0l-2.687.025 5.846 10.127 1.341-2.34-1.59-2.765 2.24-3.85-.683-1.182h-1.336l-1.57 2.705-1.56-2.72zm6.887 4.195l-5.846 10.125 2.696-.008 1.601-2.76 4.453.016.682-1.183-.666-1.157-3.13-.008L21.778 8.1l-1.365-2.313zM9.432 8.086l-2.696.008-1.601 2.76-4.453-.016L0 12.02l.666 1.157 3.13.008-1.575 2.71 1.365 2.315L9.432 8.086zM7.33 12.25l-.006.01-.002-.004-1.342 2.34 1.59 2.765-2.24 3.85.684 1.182H7.35l.004-.006h.001l1.567-2.698 1.558 2.72 2.688-.026-.004-.006h.01L7.33 12.25zm2.55 3.93l1.354 2.332 3.192.006 2.215 3.865 1.363-.002.668-1.156-1.557-2.713 3.137.008 1.32-2.34H9.881Z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/npm.svg b/website/.vitepress/theme/icons/install/npm.svg
new file mode 100644
index 0000000000..91966824f8
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/npm.svg
@@ -0,0 +1,4 @@
+<!-- npm: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://www.npmjs.com
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>npm</title><path d="M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/package.svg b/website/.vitepress/theme/icons/install/package.svg
new file mode 100644
index 0000000000..6e87bd030d
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/package.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round">
+  <path d="m12 3 9 5v8l-9 5-9-5V8l9-5Z M3 8l9 5 9-5 M12 13v8 M7.5 5.5l9 5v4"/>
+</svg>
diff --git a/website/.vitepress/theme/icons/install/python.svg b/website/.vitepress/theme/icons/install/python.svg
new file mode 100644
index 0000000000..7bcb05e996
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/python.svg
@@ -0,0 +1,4 @@
+<!-- Python: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://www.python.org/community/logos/
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Python</title><path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z"/></svg>
diff --git a/website/.vitepress/theme/icons/install/snapcraft.svg b/website/.vitepress/theme/icons/install/snapcraft.svg
new file mode 100644
index 0000000000..2bc42476ea
--- /dev/null
+++ b/website/.vitepress/theme/icons/install/snapcraft.svg
@@ -0,0 +1,5 @@
+<!-- Snapcraft: Simple Icons 16.0.0 (CC0-1.0); brand rights remain with their owners.
+Source: https://design.ubuntu.com/resources
+Icon license: CC-BY-SA-3.0 — https://creativecommons.org/licenses/by-sa/3.0/
+-->
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Snapcraft</title><path d="M8.17 11.335a.106.106 0 0 0-.173.022L1.754 23.466a.105.105 0 0 0 .032.133c.04.029.101.027.138-.012l8.89-9.11a.107.107 0 0 0 .005-.144l-2.649-3Zm9.76-3.519L.146.39C.041.346-.047.478.028.56l12.034 12.874a.11.11 0 0 0 .075.034.102.102 0 0 0 .075-.03L17.96 7.99a.106.106 0 0 0-.032-.174Zm6.047.547-2.188-4.405a.21.21 0 0 0-.189-.117h-8.77a.212.212 0 0 0-.08.408l10.96 4.405a.211.211 0 0 0 .268-.29z"/></svg>
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index bcf568b8ae..5a88702a84 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -2,243 +2,441 @@
 title: Installation
 description: Installation methods for Task
 outline: deep
+pageClass: installation-page
 ---
 
+<script setup>
+import InstallationMethod from '../../../.vitepress/components/InstallationMethod.vue';
+import InstallationMethods from '../../../.vitepress/components/InstallationMethods.vue';
+</script>
+
 # Installation
 
-Task offers many installation methods. Check out the available methods below.
+Choose a package manager for your system, or install Task from a binary.
 
-## Official Package Managers
+<InstallationMethods>
 
-These installation methods are maintained by the Task team and are always
-up-to-date.
+<nav class="installation-shortcuts" aria-label="Installation shortcuts">
+  <a href="#get-the-binary">Binaries &amp; CI</a>
+  <a href="#verify-installation">Verify installation</a>
+  <a href="#setup-completions">Shell completions</a>
+</nav>
 
-:::info Package Repository Hosting
+## Official packages {#official-package-managers}
 
-[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=for-the-badge)](https://cloudsmith.com)
+Maintained by the Task team and kept up-to-date.
 
-Package repository hosting for deb/rpm/apk is graciously provided by [Cloudsmith](https://cloudsmith.com).
-Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that
-enables your organization to create, store and share packages in any format, to any place, with total
-confidence.
+<InstallationMethod platforms="macos" platform-label="macOS">
 
-:::
+<template #heading>
+
+### [Homebrew](https://brew.sh) {#homebrew}
+
+</template>
+
+<template #links>
+
+[Tap source](https://github.com/go-task/homebrew-tap/blob/main/Casks/go-task.rb)
+[Homebrew package](https://formulae.brew.sh/formula/go-task)
+[Formula source](https://github.com/Homebrew/homebrew-core/blob/master/Formula/g/go-task.rb)
+
+</template>
+
+```shell
+brew install go-task/tap/go-task
+```
+
+Or use the Homebrew core formula:
+
+```shell
+brew install go-task
+```
+
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Fedora · CentOS · Red Hat">
+
+<template #heading>
 
-### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) ![Fedora](https://img.shields.io/badge/Fedora-51A2DA?logo=fedora&logoColor=fff) ![CentOS](https://img.shields.io/badge/CentOS-002260?logo=centos&logoColor=F0F0F0) ![Fedora](https://img.shields.io/badge/Red_Hat-EE0000?logo=redhat&logoColor=white) {#dnf}
+### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)]
+</template>
 
-If you Set up the repository by running :
+<template #links>
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)
+
+</template>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.rpm.sh' | sudo -E bash
 ```
 
-Then you can install Task with:
+Install Task:
 
 ```shell
 dnf install task
 ```
 
-### [apt](https://doc.ubuntu-fr.org/apt) ![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?logo=Ubuntu&logoColor=white) ![Debian](https://img.shields.io/badge/debian-red?logo=debian&logoColor=orange&color=darkred) ![Linux Mint](https://img.shields.io/badge/Linux%20Mint-87CF3E?logo=linuxmint&logoColor=fff) {#apt}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Ubuntu · Debian · Linux Mint">
+
+<template #heading>
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)]
+### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
 
-If you Set up the repository by running:
+</template>
+
+<template #links>
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)
+
+</template>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.deb.sh' | sudo -E bash
 ```
 
-Then you can install Task with:
+Install Task:
 
 ```shell
 apt install task
 ```
 
-### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) ![Alpine Linux](https://img.shields.io/badge/Alpine_Linux-0D597F?logo=alpinelinux&logoColor=fff) {#apk}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Alpine Linux">
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)]
+<template #heading>
 
-Set up the repository by running:
+### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
+
+</template>
+
+<template #links>
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)
+
+</template>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.alpine.sh' | sudo -E bash
 ```
 
-Then you can install Task with:
+Install Task:
 
 ```shell
 apk add task
 ```
 
-### [Homebrew](https://brew.sh) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#homebrew}
+</InstallationMethod>
 
-Task is available via our official Homebrew tap
-[[source](https://github.com/go-task/homebrew-tap/blob/main/Casks/go-task.rb)]:
+<InstallationMethod platforms="linux" platform-label="Linux">
 
-```shell
-brew install go-task/tap/go-task
-```
+<template #heading>
 
-Alternatively it can be installed from the official Homebrew repository
-[[package](https://formulae.brew.sh/formula/go-task)]
-[[source](https://github.com/Homebrew/homebrew-core/blob/master/Formula/g/go-task.rb)]
-by running:
+### [Snap](https://snapcraft.io/task) {#snap}
 
-```shell
-brew install go-task
-```
+</template>
+
+<template #links>
 
-### [Snap](https://snapcraft.io/task) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) {#snap}
+[Source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)
 
-Task is available on [Snapcraft](https://snapcraft.io/task)
-[[source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)], but
-keep in mind that your Linux distribution should allow classic confinement for
-Snaps to Task work correctly:
+</template>
 
 ```shell
 sudo snap install task --classic
 ```
 
-### [npm](https://www.npmjs.com) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#npm}
+Requires a Linux distribution with classic confinement support.
+
+</InstallationMethod>
+
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
+
+<template #heading>
+
+### [npm](https://www.npmjs.com) {#npm}
+
+</template>
+
+<template #links>
+
+[View package](https://www.npmjs.com/package/@go-task/cli)
+[Source](https://github.com/go-task/task/blob/main/package.json)
 
-Npm can be used as cross-platform way to install Task globally or as a
-dependency of your project
-[[package](https://www.npmjs.com/package/@go-task/cli)]
-[[source](https://github.com/go-task/task/blob/main/package.json)]:
+</template>
 
 ```shell
 npm install -g @go-task/cli
 ```
 
-### [WinGet](https://github.com/microsoft/winget-cli) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#winget}
+Task is also available as a project dependency.
 
-Task is available via the
-[community repository](https://github.com/microsoft/winget-pkgs)
-[[source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)]:
+</InstallationMethod>
+
+<InstallationMethod platforms="windows" platform-label="Windows">
+
+<template #heading>
+
+### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
+
+</template>
+
+<template #links>
+
+[Source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)
+
+</template>
 
 ```shell
 winget install Task.Task
 ```
 
-## Community-Maintained Package Managers
+Available through the
+[WinGet community repository](https://github.com/microsoft/winget-pkgs).
 
-::: warning Community Maintained
+</InstallationMethod>
 
-These installation methods are maintained by the community and may not always be
-up-to-date with the latest Task version. The Task team does not directly control
-these packages.
+<p class="install-hosting">Package repository hosting for deb/rpm/apk is graciously provided by <a href="https://cloudsmith.com">Cloudsmith</a>.</p>
 
-:::
+## Community packages {#community-maintained-package-managers}
 
-### [Mise](https://mise.jdx.dev/) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#mise}
+Maintained by the community, outside the Task team's control. These packages may
+lag behind the latest release.
 
-Mise is a cross-platform package manager that acts as a "frontend" to a variety
-of other package managers "backends" such as `asdf`, `aqua` and `ubi`.
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
 
-If using Mise, we recommend using the `aqua` or `ubi` backends to install Task
-as these install directly from our GitHub releases.
+<template #heading>
 
-::: code-group
+### [Mise](https://mise.jdx.dev/) {#mise}
 
-```shell [aqua]
-mise use -g aqua:go-task/task@latest
-mise install
-```
+</template>
+
+<template #links>
+
+[View package](https://mise-tools.jdx.dev/tools/task)
 
-```shell [ubi]
-mise use -g ubi:go-task/task
-mise install
+</template>
+
+```shell
+mise use -g task
 ```
 
-:::
+For a project-local installation, use `mise use task` instead. This adds Task to
+your project's `mise.toml`.
+
+</InstallationMethod>
+
+<InstallationMethod platforms="macos" platform-label="macOS">
+
+<template #heading>
 
-### [Macports](https://macports.org) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#macports}
+### [Macports](https://macports.org) {#macports}
 
-Task repository is tracked by Macports
-[[package](https://ports.macports.org/port/go-task/details/)]
-[[source](https://github.com/macports/macports-ports/blob/master/devel/go-task/Portfile)]:
+</template>
+
+<template #links>
+
+[View package](https://ports.macports.org/port/go-task/details/)
+[Source](https://github.com/macports/macports-ports/blob/master/devel/go-task/Portfile)
+
+</template>
 
 ```shell
 port install go-task
 ```
 
-### [pip](https://pip.pypa.io) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#pip}
+</InstallationMethod>
+
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
+
+<template #heading>
+
+### [pip](https://pip.pypa.io) {#pip}
+
+</template>
+
+<template #links>
+
+[View package](https://pypi.org/project/go-task-bin)
+[Source](https://github.com/Bing-su/pip-binary-factory/tree/main/task)
 
-Like npm, pip can be used as a cross-platform way to install Task
-[[package](https://pypi.org/project/go-task-bin)]
-[[source](https://github.com/Bing-su/pip-binary-factory/tree/main/task)]:
+</template>
 
 ```shell
 pip install go-task-bin
 ```
 
-### [Chocolatey](https://chocolatey.org) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#chocolatey}
+</InstallationMethod>
 
-[[package](https://community.chocolatey.org/packages/go-task)]
-[[source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)]
+<InstallationMethod platforms="windows" platform-label="Windows">
+
+<template #heading>
+
+### [Chocolatey](https://chocolatey.org) {#chocolatey}
+
+</template>
+
+<template #links>
+
+[View package](https://community.chocolatey.org/packages/go-task)
+[Source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)
+
+</template>
 
 ```shell
 choco install go-task
 ```
 
-### [Scoop](https://scoop.sh) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#scoop}
+</InstallationMethod>
+
+<InstallationMethod platforms="windows" platform-label="Windows">
+
+<template #heading>
+
+### [Scoop](https://scoop.sh) {#scoop}
+
+</template>
 
-[[source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)]
+<template #links>
+
+[Source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)
+
+</template>
 
 ```shell
 scoop install task
 ```
 
-### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) ![Arch Linux](https://img.shields.io/badge/Arch%20Linux-1793D1?logo=arch-linux&logoColor=fff) {#arch}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Arch Linux">
+
+<template #heading>
+
+### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
 
-[[package](https://archlinux.org/packages/extra/x86_64/go-task/)]
-[[source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)]
+</template>
+
+<template #links>
+
+[View package](https://archlinux.org/packages/extra/x86_64/go-task/)
+[Source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)
+
+</template>
 
 ```shell
 pacman -S go-task
 ```
 
-### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) ![Fedora](https://img.shields.io/badge/Fedora-51A2DA?logo=fedora&logoColor=fff) {#fedora-community}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Fedora">
 
-[[package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)]
-[[source](https://src.fedoraproject.org/rpms/golang-github-task)]
+<template #heading>
+
+### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
+
+</template>
+
+<template #links>
+
+[View package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
+[Source](https://src.fedoraproject.org/rpms/golang-github-task)
+
+</template>
 
 ```shell
 dnf install go-task
 ```
 
-### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) ![FreeBSD](https://img.shields.io/badge/FreeBSD-990000?logo=freebsd&logoColor=fff) {#freebsd}
+</InstallationMethod>
+
+<InstallationMethod platforms="freebsd" platform-label="FreeBSD">
+
+<template #heading>
+
+### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
+
+</template>
 
-[[package](https://cgit.freebsd.org/ports/tree/devel/task)]
-[[source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)]
+<template #links>
+
+[View package](https://cgit.freebsd.org/ports/tree/devel/task)
+[Source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)
+
+</template>
 
 ```shell
 pkg install task
 ```
 
-### [Nix](https://nixos.org) ![Nix](https://img.shields.io/badge/Nix-5277C3?logo=nixos&logoColor=fff) ![NixOS](https://img.shields.io/badge/NixOS-5277C3?logo=nixos&logoColor=fff) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#nix}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux macos" platform-label="Nix · NixOS · Linux · macOS">
+
+<template #heading>
+
+### [Nix](https://nixos.org) {#nix}
 
-[[source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)]
+</template>
+
+<template #links>
+
+[Source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)
+
+</template>
 
 ```shell
 nix-env -iA nixpkgs.go-task
 ```
 
-### [pacstall](https://github.com/pacstall/pacstall) ![Debian](https://img.shields.io/badge/Debian-A81D33?logo=debian&logoColor=fff) ![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?logo=ubuntu&logoColor=fff) {#pacstall}
+</InstallationMethod>
+
+<InstallationMethod platforms="linux" platform-label="Debian · Ubuntu">
 
-[[package](https://pacstall.dev/packages/go-task-deb)]
-[[source](https://github.com/pacstall/pacstall-programs/blob/master/packages/go-task-deb/go-task-deb.pacscript)]
+<template #heading>
+
+### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
+
+</template>
+
+<template #links>
+
+[View package](https://pacstall.dev/packages/go-task-deb)
+[Source](https://github.com/pacstall/pacstall-programs/blob/master/packages/go-task-deb/go-task-deb.pacscript)
+
+</template>
 
 ```shell
 pacstall -I go-task-deb
 ```
 
-### [pkgx](https://pkgx.sh) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black) {#pkgx}
+</InstallationMethod>
+
+<InstallationMethod platforms="macos linux" platform-label="macOS · Linux">
+
+<template #heading>
+
+### [pkgx](https://pkgx.sh) {#pkgx}
+
+</template>
+
+<template #links>
 
-[[package](https://pkgx.dev/pkgs/taskfile.dev)]
-[[source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)]
+[View package](https://pkgx.dev/pkgs/taskfile.dev)
+[Source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)
+
+</template>
 
 ```shell
 pkgx task
@@ -250,75 +448,88 @@ or, if you have pkgx integration enabled:
 task
 ```
 
-## Get The Binary
+</InstallationMethod>
 
-### Binary
+</InstallationMethods>
 
-You can download the binary from the
-[releases page on GitHub](https://github.com/go-task/task/releases) and add to
-your `$PATH`.
+## Binaries & CI {#get-the-binary}
 
-DEB, RPM and APK packages are also available.
+Install Task without a package manager: download a binary, use the install
+script, or add the setup action to your GitHub workflow.
 
-The `task_checksums.txt` file contains the SHA-256 checksum for each file.
+### Download a binary {#binary}
 
-### Install Script
+1. Open the [GitHub releases](https://github.com/go-task/task/releases) and
+   download the archive for your operating system and architecture.
+2. Extract `task` (`task.exe` on Windows).
+3. Move the executable to a directory on your `PATH`.
 
-We also have an
-[install script](https://github.com/go-task/task/blob/main/install-task.sh)
-which is very useful in scenarios like CI. Many thanks to
-[GoDownloader](https://github.com/goreleaser/godownloader) for enabling the easy
-generation of this script.
+Each release also includes DEB, RPM and APK packages, plus `task_checksums.txt`
+with SHA-256 checksums for the release files.
 
-By default, it installs on the `./bin` directory relative to the working
-directory:
+### Install with a script {#install-script}
 
-```shell
+Use the
+[install script](https://github.com/go-task/task/blob/main/install-task.sh) for
+a shell-based installation, including CI environments. It downloads a prebuilt
+binary and verifies its checksum; no Go installation is needed.
+
+By default, the script installs the latest release into `./bin`, relative to
+your current directory. Choose a different directory or pin a release:
+
+::: code-group
+
+```shell [Latest release]
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d
 ```
 
-It is possible to override the installation directory with the `-b` parameter.
-On Linux, common choices are `~/.local/bin` and `~/bin` to install for the
-current user or `/usr/local/bin` to install for all users:
-
-```shell
+```shell [Custom directory]
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
 ```
 
-::: warning
+```shell [Pinned version]
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.42.1
+```
 
-On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by
-default.
+```shell [Directory + version]
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
+```
 
 :::
 
-By default, it installs the latest version available. You can also specify a tag
-(available in [releases](https://github.com/go-task/task/releases)) to install a
-specific version:
+When combining options, keep the
+[release tag](https://github.com/go-task/task/releases) last.
 
-```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.36.0
-```
+::: tip Make Task available in your shell
 
-Parameters are order specific, to set both installation directory and version:
+Add the installation directory to your `PATH` to run `task` from anywhere. With
+the default location, you can also run `./bin/task` directly.
 
-```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
-```
+On Linux, `~/.local/bin` and `~/bin` are common per-user locations;
+`/usr/local/bin` is a system-wide location and may require elevated permissions.
+Do not assume these directories are already on your `PATH`, especially on macOS
+and Windows.
+
+:::
 
 ### GitHub Actions
 
-We have an [official GitHub Action](https://github.com/go-task/setup-task) to
-install Task in your GitHub workflows. This repository is forked from the
-fantastic project by the Arduino team. Check out the repository for more
-examples and configuration.
+Add the [official setup action](https://github.com/go-task/setup-task) to your
+job's `steps` before running Task:
 
 ```yaml
 - name: Install Task
-  uses: go-task/setup-task@v1
+  uses: go-task/setup-task@v2
+
+- name: Verify Task
+  run: task --version
 ```
 
-## Build From Source
+Use the action's `version` input to pin a Task release. See the
+[action documentation](https://github.com/go-task/setup-task#usage) for examples
+and configuration.
+
+## Build from source
 
 Ensure that you have a supported version of [Go](https://golang.org) properly
 installed and setup. You can find the minimum required version of Go in the
@@ -364,7 +575,20 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
-## Setup completions
+## Verify installation
+
+After installing, open a terminal and check that Task is available:
+
+```shell
+task --version
+```
+
+If you installed Task with `go tool`, run `go tool task --version` instead.
+
+You're ready to [create your first Taskfile](./getting-started.md). You can also
+enable shell completions below.
+
+## Shell completions {#setup-completions}
 
 Some installation methods will automatically install completions too, but if
 this isn't working for you or your chosen method doesn't include them, you can
@@ -376,8 +600,8 @@ config:
 
 This method loads the completion script from the currently installed version of
 task every time you create a new shell. This ensures that your completions are
-always up-to-date.
-If your executable isn’t named task, set the `TASK_EXE` environment variable before running eval.
+always up-to-date. If your executable isn’t named task, set the `TASK_EXE`
+environment variable before running eval.
 
 ::: code-group
 
@@ -446,9 +670,10 @@ task --completion nu | save --force ($nu.data-dir | path join "vendor/autoload/t
 
 ### Zsh customization
 
-The Zsh completion supports the standard `verbose` zstyle to control whether task
-descriptions are shown. By default, descriptions are displayed. To show only task
-names without descriptions, add this to your `~/.zshrc` (after the completion is loaded):
+The Zsh completion supports the standard `verbose` zstyle to control whether
+task descriptions are shown. By default, descriptions are displayed. To show
+only task names without descriptions, add this to your `~/.zshrc` (after the
+completion is loaded):
 
 ```shell
 zstyle ':completion:*:*:task:*' verbose false
@@ -463,18 +688,19 @@ zstyle ':completion:*:*:task:*' show-aliases false
 
 ### Nushell caveats
 
-Nushell cannot source a script from stdin, so both options above write the script
-to an autoload directory. Option 1 rewrites it at every startup, which keeps it
-in sync with the installed version of Task — the refreshed completions are picked
-up by the next shell. With option 2, re-run the command after upgrading Task.
+Nushell cannot source a script from stdin, so both options above write the
+script to an autoload directory. Option 1 rewrites it at every startup, which
+keeps it in sync with the installed version of Task — the refreshed completions
+are picked up by the next shell. With option 2, re-run the command after
+upgrading Task.
 
 The completions are attached to an `extern "task"` declaration, which Nushell
 requires to be static. Three consequences are worth knowing:
 
-- The experimental flags (`--force-all`, `--download`, `--offline`, …) are always
-  offered, even when the corresponding experiment is disabled. Their description
-  is prefixed with the experiment name, and `task --experiments` lists the ones
-  that are enabled.
+- The experimental flags (`--force-all`, `--download`, `--offline`, …) are
+  always offered, even when the corresponding experiment is disabled. Their
+  description is prefixed with the experiment name, and `task --experiments`
+  lists the ones that are enabled.
 - Passing a value to a boolean flag with `=` does not work: Nushell forwards
   `--color=false` as two arguments, so Task reads `false` as a task name. Use
   `NO_COLOR=1`, or bypass the declaration with `^task --color=false`.