From 27c86c08a9bb45440cce5532b5574274dba17eb0 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:07:41 +0200
Subject: [PATCH 01/12] docs: redesign installation page

---
 .../components/InstallationMethods.vue        | 376 ++++++++++++++
 website/src/latest/docs/installation.md       | 464 ++++++++++++++----
 website/src/next/docs/installation.md         | 464 ++++++++++++++----
 3 files changed, 1094 insertions(+), 210 deletions(-)
 create mode 100644 website/.vitepress/components/InstallationMethods.vue

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
new file mode 100644
index 0000000000..8d24841c64
--- /dev/null
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -0,0 +1,376 @@
+<script setup lang="ts">
+import { nextTick, onMounted, onUnmounted, ref } from 'vue';
+
+const platforms = [
+  { id: 'all', label: 'All systems' },
+  { 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)"
+        >
+          {{ 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: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 12px;
+  margin: 28px 0 32px;
+}
+
+:global(.installation-page .installation-shortcuts a) {
+  display: flex;
+  flex-direction: column;
+  padding: 18px 16px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  background: var(--vp-c-bg-soft);
+  color: var(--vp-c-text-1);
+  text-decoration: none;
+  transition: border-color 0.15s;
+}
+
+:global(.installation-page .installation-shortcuts a:hover) {
+  border-color: var(--vp-c-brand-1);
+}
+
+:global(.installation-page .installation-shortcuts a:focus-visible) {
+  outline: 2px solid var(--vp-c-brand-1);
+  outline-offset: 3px;
+}
+
+:global(.installation-page .installation-shortcuts span) {
+  margin-bottom: 12px;
+  color: var(--vp-c-text-2);
+  font-family: var(--vp-font-family-mono);
+  font-size: 12px;
+}
+
+:global(.installation-page .installation-shortcuts strong) {
+  font-size: 14px;
+  font-weight: 600;
+  line-height: 22px;
+}
+
+:global(.installation-page .installation-shortcuts small) {
+  margin-top: 4px;
+  color: var(--vp-c-text-2);
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.install-picker {
+  margin: 28px 0 32px;
+}
+
+.install-picker-label {
+  display: block;
+  margin-bottom: 12px;
+  color: var(--vp-c-text-2);
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.install-platform-buttons {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  width: fit-content;
+  padding: 5px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  background: var(--vp-c-bg-soft);
+}
+
+.install-platform-buttons button {
+  min-height: 40px;
+  padding: 8px 18px;
+  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: var(--vp-c-text-1);
+  background: var(--vp-c-bg);
+  box-shadow: 0 1px 4px rgb(0 0 0 / 10%);
+}
+
+.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(.install-method) {
+  position: relative;
+  margin: 16px 0;
+  padding: 24px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  background: var(--vp-c-bg);
+}
+
+.installation-methods :deep(.install-method h3) {
+  margin: 0 0 4px;
+  padding: 0;
+  font-size: 19px;
+  line-height: 28px;
+}
+
+.installation-methods :deep(.install-method h3 a:not(.header-anchor)) {
+  color: var(--vp-c-text-1);
+  text-decoration: none;
+}
+
+.installation-methods :deep(.install-method h3 a:hover) {
+  color: var(--vp-c-brand-1);
+}
+
+.installation-methods :deep(.install-meta) {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px 16px;
+  margin: 8px 0 20px;
+}
+
+.installation-methods :deep(.install-method .install-platforms) {
+  margin: 0;
+  color: var(--vp-c-text-2);
+  font-size: 12px;
+  line-height: 20px;
+  font-weight: 500;
+}
+
+.installation-methods :deep(.install-links p) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 0;
+}
+
+.installation-methods :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;
+}
+
+.installation-methods :deep(.install-links a:hover) {
+  border-color: var(--vp-c-brand-1);
+}
+
+.installation-methods :deep(.install-links a:focus-visible) {
+  outline: 2px solid var(--vp-c-brand-1);
+  outline-offset: 2px;
+}
+
+.installation-methods :deep(.install-method p) {
+  font-size: 14px;
+  line-height: 24px;
+}
+
+.installation-methods :deep(.install-method > :last-child) {
+  margin-bottom: 0;
+}
+
+.installation-methods :deep(.install-method div[class*='language-']) {
+  margin: 16px 0;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+}
+
+.installation-methods :deep(.install-method div[class*='language-'] pre) {
+  padding: 16px 0;
+}
+
+.installation-methods :deep(.install-method div[class*='language-'] code) {
+  padding: 0 18px;
+  font-size: 13px;
+}
+
+.installation-methods :deep(.install-method .vp-code-group) {
+  margin-top: 16px;
+}
+
+.installation-methods :deep(.install-method .vp-code-group .tabs) {
+  margin: 0;
+  border-radius: 8px 8px 0 0;
+}
+
+.installation-methods
+  :deep(.install-method .vp-code-group div[class*='language-']) {
+  margin: 0;
+  border-radius: 0 0 8px 8px;
+}
+
+.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) {
+  :global(.installation-page .installation-shortcuts) {
+    grid-template-columns: 1fr;
+    gap: 8px;
+  }
+
+  :global(.installation-page .installation-shortcuts a) {
+    display: grid;
+    grid-template-columns: 24px 1fr;
+    column-gap: 12px;
+    padding: 12px 16px;
+  }
+
+  :global(.installation-page .installation-shortcuts span) {
+    grid-row: span 2;
+    align-self: center;
+    margin: 0;
+  }
+
+  :global(.installation-page .installation-shortcuts small) {
+    margin-top: 0;
+  }
+
+  .install-platform-buttons {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    width: 100%;
+  }
+
+  .installation-methods :deep(.install-method) {
+    padding: 20px 16px;
+  }
+}
+
+@media print {
+  .install-picker {
+    display: none;
+  }
+
+  .installation-methods :deep(.install-method) {
+    display: block !important;
+    break-inside: avoid;
+  }
+}
+</style>
diff --git a/website/src/latest/docs/installation.md b/website/src/latest/docs/installation.md
index bcf568b8ae..e40b6ddf3a 100644
--- a/website/src/latest/docs/installation.md
+++ b/website/src/latest/docs/installation.md
@@ -2,33 +2,81 @@
 title: Installation
 description: Installation methods for Task
 outline: deep
+pageClass: installation-page
 ---
 
+<script setup>
+import InstallationMethods from '../../../.vitepress/components/InstallationMethods.vue';
+</script>
+
 # Installation
 
-Task offers many installation methods. Check out the available methods below.
+Install Task with your preferred package manager, download a binary, or set it
+up in CI. Then add shell completions and you're ready to go.
+
+<nav class="installation-shortcuts" aria-label="Installation shortcuts">
+  <a href="#official-package-managers"><span>01</span><strong>Package managers</strong><small>Find your preferred method</small></a>
+  <a href="#get-the-binary"><span>02</span><strong>Binaries &amp; CI</strong><small>Downloads, scripts and actions</small></a>
+  <a href="#setup-completions"><span>03</span><strong>Shell completions</strong><small>Finish your setup</small></a>
+</nav>
+
+<InstallationMethods>
 
-## Official Package Managers
+## Official packages {#official-package-managers}
 
 These installation methods are maintained by the Task team and are always
 up-to-date.
 
-:::info Package Repository Hosting
+<div class="install-method" data-platforms="macos">
 
-[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=for-the-badge)](https://cloudsmith.com)
+### [Homebrew](https://brew.sh) {#homebrew}
 
-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.
+<div class="install-meta">
 
-:::
+<p class="install-platforms">macOS</p>
+
+<div class="install-links">
 
-### [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}
+[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)
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)]
+</div>
 
-If you Set up the repository by running :
+</div>
+
+Task is available via our official Homebrew tap:
+
+```shell
+brew install go-task/tap/go-task
+```
+
+Alternatively it can be installed from the official Homebrew repository by
+running:
+
+```shell
+brew install go-task
+```
+
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
+
+<div class="install-meta">
+
+<p class="install-platforms">Fedora · CentOS · Red Hat</p>
+
+<div class="install-links">
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)
+
+</div>
+
+</div>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.rpm.sh' | sudo -E bash
@@ -40,11 +88,25 @@ Then you can install Task with:
 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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
+
+<div class="install-meta">
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)]
+<p class="install-platforms">Ubuntu · Debian · Linux Mint</p>
 
-If you Set up the repository by running:
+<div class="install-links">
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)
+
+</div>
+
+</div>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.deb.sh' | sudo -E bash
@@ -56,9 +118,23 @@ Then you can install Task with:
 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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
+
+<div class="install-meta">
+
+<p class="install-platforms">Alpine Linux</p>
+
+<div class="install-links">
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)]
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)
+
+</div>
+
+</div>
 
 Set up the repository by running:
 
@@ -72,173 +148,345 @@ Then you can install Task with:
 apk add task
 ```
 
-### [Homebrew](https://brew.sh) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#homebrew}
+</div>
 
-Task is available via our official Homebrew tap
-[[source](https://github.com/go-task/homebrew-tap/blob/main/Casks/go-task.rb)]:
+<div class="install-method" data-platforms="linux">
 
-```shell
-brew install go-task/tap/go-task
-```
+### [Snap](https://snapcraft.io/task) {#snap}
 
-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:
+<div class="install-meta">
 
-```shell
-brew install go-task
-```
+<p class="install-platforms">Linux</p>
+
+<div class="install-links">
+
+[Source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)
 
-### [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}
+</div>
 
-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:
+</div>
+
+Task is available on [Snapcraft](https://snapcraft.io/task), but keep in mind
+that your Linux distribution should allow classic confinement for Snaps to Task
+work correctly:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="macos linux windows">
+
+### [npm](https://www.npmjs.com) {#npm}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS · Linux · Windows</p>
+
+<div class="install-links">
+
+[View package](https://www.npmjs.com/package/@go-task/cli)
+[Source](https://github.com/go-task/task/blob/main/package.json)
+
+</div>
+
+</div>
 
 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)]:
+dependency of your project:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
+
+<div class="install-links">
+
+[Source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)
+
+</div>
+
+</div>
 
 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)]:
+[community repository](https://github.com/microsoft/winget-pkgs):
 
 ```shell
 winget install Task.Task
 ```
 
-## Community-Maintained Package Managers
+</div>
+
+<p class="install-hosting">Package repository hosting for deb/rpm/apk is graciously provided by <a href="https://cloudsmith.com">Cloudsmith</a>.</p>
 
-::: warning Community Maintained
+## Community packages {#community-maintained-package-managers}
 
 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.
 
-:::
+<div class="install-method" data-platforms="macos linux windows">
 
-### [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}
+### [Mise](https://mise.jdx.dev/) {#mise}
 
-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`.
+<div class="install-meta">
 
-If using Mise, we recommend using the `aqua` or `ubi` backends to install Task
-as these install directly from our GitHub releases.
+<p class="install-platforms">macOS · Linux · Windows</p>
 
-::: code-group
+<div class="install-links">
 
-```shell [aqua]
-mise use -g aqua:go-task/task@latest
-mise install
-```
+[View package](https://mise-tools.jdx.dev/tools/task)
+
+</div>
+
+</div>
 
-```shell [ubi]
-mise use -g ubi:go-task/task
-mise install
+Install and activate Task globally with Mise:
+
+```shell
+mise use -g task
 ```
 
-:::
+To use Task in the current project instead, run `mise use task`. This installs
+Task and adds it to your project's `mise.toml`.
+
+</div>
 
-### [Macports](https://macports.org) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#macports}
+<div class="install-method" data-platforms="macos">
 
-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)]:
+### [Macports](https://macports.org) {#macports}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS</p>
+
+<div class="install-links">
+
+[View package](https://ports.macports.org/port/go-task/details/)
+[Source](https://github.com/macports/macports-ports/blob/master/devel/go-task/Portfile)
+
+</div>
+
+</div>
+
+Task repository is tracked by Macports:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="macos linux windows">
+
+### [pip](https://pip.pypa.io) {#pip}
+
+<div class="install-meta">
 
-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)]:
+<p class="install-platforms">macOS · Linux · Windows</p>
+
+<div class="install-links">
+
+[View package](https://pypi.org/project/go-task-bin)
+[Source](https://github.com/Bing-su/pip-binary-factory/tree/main/task)
+
+</div>
+
+</div>
+
+Like npm, pip can be used as a cross-platform way to install Task:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [Chocolatey](https://chocolatey.org) {#chocolatey}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
 
-[[package](https://community.chocolatey.org/packages/go-task)]
-[[source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)]
+<div class="install-links">
+
+[View package](https://community.chocolatey.org/packages/go-task)
+[Source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)
+
+</div>
+
+</div>
 
 ```shell
 choco install go-task
 ```
 
-### [Scoop](https://scoop.sh) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#scoop}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [Scoop](https://scoop.sh) {#scoop}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
+
+<div class="install-links">
+
+[Source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)
 
-[[source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)]
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
+
+<div class="install-meta">
+
+<p class="install-platforms">Arch Linux</p>
 
-[[package](https://archlinux.org/packages/extra/x86_64/go-task/)]
-[[source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)]
+<div class="install-links">
+
+[View package](https://archlinux.org/packages/extra/x86_64/go-task/)
+[Source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
 
-[[package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)]
-[[source](https://src.fedoraproject.org/rpms/golang-github-task)]
+### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
+
+<div class="install-meta">
+
+<p class="install-platforms">Fedora</p>
+
+<div class="install-links">
+
+[View package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
+[Source](https://src.fedoraproject.org/rpms/golang-github-task)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="freebsd">
+
+### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
+
+<div class="install-meta">
 
-[[package](https://cgit.freebsd.org/ports/tree/devel/task)]
-[[source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)]
+<p class="install-platforms">FreeBSD</p>
+
+<div class="install-links">
+
+[View package](https://cgit.freebsd.org/ports/tree/devel/task)
+[Source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux macos">
+
+### [Nix](https://nixos.org) {#nix}
+
+<div class="install-meta">
+
+<p class="install-platforms">Nix · NixOS · Linux · macOS</p>
+
+<div class="install-links">
 
-[[source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)]
+[Source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
+
+<div class="install-meta">
+
+<p class="install-platforms">Debian · Ubuntu</p>
+
+<div class="install-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)
+
+</div>
 
-[[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)]
+</div>
 
 ```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}
+</div>
 
-[[package](https://pkgx.dev/pkgs/taskfile.dev)]
-[[source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)]
+<div class="install-method" data-platforms="macos linux">
+
+### [pkgx](https://pkgx.sh) {#pkgx}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS · Linux</p>
+
+<div class="install-links">
+
+[View package](https://pkgx.dev/pkgs/taskfile.dev)
+[Source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)
+
+</div>
+
+</div>
 
 ```shell
 pkgx task
@@ -250,7 +498,11 @@ or, if you have pkgx integration enabled:
 task
 ```
 
-## Get The Binary
+</div>
+
+</InstallationMethods>
+
+## Binaries & CI {#get-the-binary}
 
 ### Binary
 
@@ -318,7 +570,7 @@ examples and configuration.
   uses: go-task/setup-task@v1
 ```
 
-## Build From Source
+## 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 +616,7 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
-## Setup completions
+## 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 +628,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 +698,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 +716,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`.
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index bcf568b8ae..e40b6ddf3a 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -2,33 +2,81 @@
 title: Installation
 description: Installation methods for Task
 outline: deep
+pageClass: installation-page
 ---
 
+<script setup>
+import InstallationMethods from '../../../.vitepress/components/InstallationMethods.vue';
+</script>
+
 # Installation
 
-Task offers many installation methods. Check out the available methods below.
+Install Task with your preferred package manager, download a binary, or set it
+up in CI. Then add shell completions and you're ready to go.
+
+<nav class="installation-shortcuts" aria-label="Installation shortcuts">
+  <a href="#official-package-managers"><span>01</span><strong>Package managers</strong><small>Find your preferred method</small></a>
+  <a href="#get-the-binary"><span>02</span><strong>Binaries &amp; CI</strong><small>Downloads, scripts and actions</small></a>
+  <a href="#setup-completions"><span>03</span><strong>Shell completions</strong><small>Finish your setup</small></a>
+</nav>
+
+<InstallationMethods>
 
-## Official Package Managers
+## Official packages {#official-package-managers}
 
 These installation methods are maintained by the Task team and are always
 up-to-date.
 
-:::info Package Repository Hosting
+<div class="install-method" data-platforms="macos">
 
-[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=for-the-badge)](https://cloudsmith.com)
+### [Homebrew](https://brew.sh) {#homebrew}
 
-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.
+<div class="install-meta">
 
-:::
+<p class="install-platforms">macOS</p>
+
+<div class="install-links">
 
-### [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}
+[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)
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)]
+</div>
 
-If you Set up the repository by running :
+</div>
+
+Task is available via our official Homebrew tap:
+
+```shell
+brew install go-task/tap/go-task
+```
+
+Alternatively it can be installed from the official Homebrew repository by
+running:
+
+```shell
+brew install go-task
+```
+
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
+
+<div class="install-meta">
+
+<p class="install-platforms">Fedora · CentOS · Red Hat</p>
+
+<div class="install-links">
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)
+
+</div>
+
+</div>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.rpm.sh' | sudo -E bash
@@ -40,11 +88,25 @@ Then you can install Task with:
 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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
+
+<div class="install-meta">
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)]
+<p class="install-platforms">Ubuntu · Debian · Linux Mint</p>
 
-If you Set up the repository by running:
+<div class="install-links">
+
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)
+
+</div>
+
+</div>
+
+Set up the repository:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.deb.sh' | sudo -E bash
@@ -56,9 +118,23 @@ Then you can install Task with:
 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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
+
+<div class="install-meta">
+
+<p class="install-platforms">Alpine Linux</p>
+
+<div class="install-links">
 
-[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)]
+[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)
+
+</div>
+
+</div>
 
 Set up the repository by running:
 
@@ -72,173 +148,345 @@ Then you can install Task with:
 apk add task
 ```
 
-### [Homebrew](https://brew.sh) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#homebrew}
+</div>
 
-Task is available via our official Homebrew tap
-[[source](https://github.com/go-task/homebrew-tap/blob/main/Casks/go-task.rb)]:
+<div class="install-method" data-platforms="linux">
 
-```shell
-brew install go-task/tap/go-task
-```
+### [Snap](https://snapcraft.io/task) {#snap}
 
-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:
+<div class="install-meta">
 
-```shell
-brew install go-task
-```
+<p class="install-platforms">Linux</p>
+
+<div class="install-links">
+
+[Source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)
 
-### [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}
+</div>
 
-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:
+</div>
+
+Task is available on [Snapcraft](https://snapcraft.io/task), but keep in mind
+that your Linux distribution should allow classic confinement for Snaps to Task
+work correctly:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="macos linux windows">
+
+### [npm](https://www.npmjs.com) {#npm}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS · Linux · Windows</p>
+
+<div class="install-links">
+
+[View package](https://www.npmjs.com/package/@go-task/cli)
+[Source](https://github.com/go-task/task/blob/main/package.json)
+
+</div>
+
+</div>
 
 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)]:
+dependency of your project:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
+
+<div class="install-links">
+
+[Source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)
+
+</div>
+
+</div>
 
 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)]:
+[community repository](https://github.com/microsoft/winget-pkgs):
 
 ```shell
 winget install Task.Task
 ```
 
-## Community-Maintained Package Managers
+</div>
+
+<p class="install-hosting">Package repository hosting for deb/rpm/apk is graciously provided by <a href="https://cloudsmith.com">Cloudsmith</a>.</p>
 
-::: warning Community Maintained
+## Community packages {#community-maintained-package-managers}
 
 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.
 
-:::
+<div class="install-method" data-platforms="macos linux windows">
 
-### [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}
+### [Mise](https://mise.jdx.dev/) {#mise}
 
-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`.
+<div class="install-meta">
 
-If using Mise, we recommend using the `aqua` or `ubi` backends to install Task
-as these install directly from our GitHub releases.
+<p class="install-platforms">macOS · Linux · Windows</p>
 
-::: code-group
+<div class="install-links">
 
-```shell [aqua]
-mise use -g aqua:go-task/task@latest
-mise install
-```
+[View package](https://mise-tools.jdx.dev/tools/task)
+
+</div>
+
+</div>
 
-```shell [ubi]
-mise use -g ubi:go-task/task
-mise install
+Install and activate Task globally with Mise:
+
+```shell
+mise use -g task
 ```
 
-:::
+To use Task in the current project instead, run `mise use task`. This installs
+Task and adds it to your project's `mise.toml`.
+
+</div>
 
-### [Macports](https://macports.org) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#macports}
+<div class="install-method" data-platforms="macos">
 
-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)]:
+### [Macports](https://macports.org) {#macports}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS</p>
+
+<div class="install-links">
+
+[View package](https://ports.macports.org/port/go-task/details/)
+[Source](https://github.com/macports/macports-ports/blob/master/devel/go-task/Portfile)
+
+</div>
+
+</div>
+
+Task repository is tracked by Macports:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="macos linux windows">
+
+### [pip](https://pip.pypa.io) {#pip}
+
+<div class="install-meta">
 
-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)]:
+<p class="install-platforms">macOS · Linux · Windows</p>
+
+<div class="install-links">
+
+[View package](https://pypi.org/project/go-task-bin)
+[Source](https://github.com/Bing-su/pip-binary-factory/tree/main/task)
+
+</div>
+
+</div>
+
+Like npm, pip can be used as a cross-platform way to install Task:
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [Chocolatey](https://chocolatey.org) {#chocolatey}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
 
-[[package](https://community.chocolatey.org/packages/go-task)]
-[[source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)]
+<div class="install-links">
+
+[View package](https://community.chocolatey.org/packages/go-task)
+[Source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)
+
+</div>
+
+</div>
 
 ```shell
 choco install go-task
 ```
 
-### [Scoop](https://scoop.sh) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#scoop}
+</div>
+
+<div class="install-method" data-platforms="windows">
+
+### [Scoop](https://scoop.sh) {#scoop}
+
+<div class="install-meta">
+
+<p class="install-platforms">Windows</p>
+
+<div class="install-links">
+
+[Source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)
 
-[[source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)]
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
+
+<div class="install-meta">
+
+<p class="install-platforms">Arch Linux</p>
 
-[[package](https://archlinux.org/packages/extra/x86_64/go-task/)]
-[[source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)]
+<div class="install-links">
+
+[View package](https://archlinux.org/packages/extra/x86_64/go-task/)
+[Source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
 
-[[package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)]
-[[source](https://src.fedoraproject.org/rpms/golang-github-task)]
+### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
+
+<div class="install-meta">
+
+<p class="install-platforms">Fedora</p>
+
+<div class="install-links">
+
+[View package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
+[Source](https://src.fedoraproject.org/rpms/golang-github-task)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="freebsd">
+
+### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
+
+<div class="install-meta">
 
-[[package](https://cgit.freebsd.org/ports/tree/devel/task)]
-[[source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)]
+<p class="install-platforms">FreeBSD</p>
+
+<div class="install-links">
+
+[View package](https://cgit.freebsd.org/ports/tree/devel/task)
+[Source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux macos">
+
+### [Nix](https://nixos.org) {#nix}
+
+<div class="install-meta">
+
+<p class="install-platforms">Nix · NixOS · Linux · macOS</p>
+
+<div class="install-links">
 
-[[source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)]
+[Source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)
+
+</div>
+
+</div>
 
 ```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}
+</div>
+
+<div class="install-method" data-platforms="linux">
+
+### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
+
+<div class="install-meta">
+
+<p class="install-platforms">Debian · Ubuntu</p>
+
+<div class="install-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)
+
+</div>
 
-[[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)]
+</div>
 
 ```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}
+</div>
 
-[[package](https://pkgx.dev/pkgs/taskfile.dev)]
-[[source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)]
+<div class="install-method" data-platforms="macos linux">
+
+### [pkgx](https://pkgx.sh) {#pkgx}
+
+<div class="install-meta">
+
+<p class="install-platforms">macOS · Linux</p>
+
+<div class="install-links">
+
+[View package](https://pkgx.dev/pkgs/taskfile.dev)
+[Source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)
+
+</div>
+
+</div>
 
 ```shell
 pkgx task
@@ -250,7 +498,11 @@ or, if you have pkgx integration enabled:
 task
 ```
 
-## Get The Binary
+</div>
+
+</InstallationMethods>
+
+## Binaries & CI {#get-the-binary}
 
 ### Binary
 
@@ -318,7 +570,7 @@ examples and configuration.
   uses: go-task/setup-task@v1
 ```
 
-## Build From Source
+## 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 +616,7 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
-## Setup completions
+## 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 +628,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 +698,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 +716,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`.

From b4f46106004447b793986d65112e0715dcc27ef2 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:17:32 +0200
Subject: [PATCH 02/12] docs: streamline installation flow

---
 .../components/InstallationMethods.vue        | 164 ++++++++++--------
 website/src/latest/docs/installation.md       |  74 ++++----
 website/src/next/docs/installation.md         |  74 ++++----
 3 files changed, 161 insertions(+), 151 deletions(-)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 8d24841c64..78caba656e 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -2,7 +2,7 @@
 import { nextTick, onMounted, onUnmounted, ref } from 'vue';
 
 const platforms = [
-  { id: 'all', label: 'All systems' },
+  { id: 'all', label: 'All' },
   { id: 'macos', label: 'macOS' },
   { id: 'linux', label: 'Linux' },
   { id: 'windows', label: 'Windows' }
@@ -84,6 +84,33 @@ onUnmounted(() => {
           :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>
@@ -97,26 +124,24 @@ onUnmounted(() => {
 
 <style scoped>
 :global(.installation-page .installation-shortcuts) {
-  display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 12px;
-  margin: 28px 0 32px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 20px;
+  margin: 12px 0 24px;
 }
 
 :global(.installation-page .installation-shortcuts a) {
-  display: flex;
-  flex-direction: column;
-  padding: 18px 16px;
-  border: 1px solid var(--vp-c-divider);
-  border-radius: 12px;
-  background: var(--vp-c-bg-soft);
-  color: var(--vp-c-text-1);
+  padding: 4px 0;
+  color: var(--vp-c-text-2);
+  font-size: 13px;
+  line-height: 20px;
   text-decoration: none;
-  transition: border-color 0.15s;
 }
 
 :global(.installation-page .installation-shortcuts a:hover) {
-  border-color: var(--vp-c-brand-1);
+  color: var(--vp-c-brand-1);
+  text-decoration: underline;
+  text-underline-offset: 4px;
 }
 
 :global(.installation-page .installation-shortcuts a:focus-visible) {
@@ -124,33 +149,13 @@ onUnmounted(() => {
   outline-offset: 3px;
 }
 
-:global(.installation-page .installation-shortcuts span) {
-  margin-bottom: 12px;
-  color: var(--vp-c-text-2);
-  font-family: var(--vp-font-family-mono);
-  font-size: 12px;
-}
-
-:global(.installation-page .installation-shortcuts strong) {
-  font-size: 14px;
-  font-weight: 600;
-  line-height: 22px;
-}
-
-:global(.installation-page .installation-shortcuts small) {
-  margin-top: 4px;
-  color: var(--vp-c-text-2);
-  font-size: 12px;
-  line-height: 20px;
-}
-
 .install-picker {
-  margin: 28px 0 32px;
+  margin: 24px 0 0;
 }
 
 .install-picker-label {
   display: block;
-  margin-bottom: 12px;
+  margin-bottom: 8px;
   color: var(--vp-c-text-2);
   font-size: 13px;
   font-weight: 600;
@@ -158,18 +163,22 @@ onUnmounted(() => {
 
 .install-platform-buttons {
   display: flex;
-  flex-wrap: wrap;
-  gap: 6px;
+  gap: 3px;
   width: fit-content;
-  padding: 5px;
+  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 18px;
+  padding: 8px 16px;
   border-radius: 8px;
   color: var(--vp-c-text-2);
   font-size: 14px;
@@ -185,9 +194,16 @@ onUnmounted(() => {
 }
 
 .install-platform-buttons button[aria-pressed='true'] {
-  color: var(--vp-c-text-1);
-  background: var(--vp-c-bg);
-  box-shadow: 0 1px 4px rgb(0 0 0 / 10%);
+  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 {
@@ -207,7 +223,7 @@ onUnmounted(() => {
 .installation-methods :deep(.install-method) {
   position: relative;
   margin: 16px 0;
-  padding: 24px;
+  padding: 20px;
   border: 1px solid var(--vp-c-divider);
   border-radius: 12px;
   background: var(--vp-c-bg);
@@ -216,8 +232,8 @@ onUnmounted(() => {
 .installation-methods :deep(.install-method h3) {
   margin: 0 0 4px;
   padding: 0;
-  font-size: 19px;
-  line-height: 28px;
+  font-size: 18px;
+  line-height: 26px;
 }
 
 .installation-methods :deep(.install-method h3 a:not(.header-anchor)) {
@@ -235,7 +251,7 @@ onUnmounted(() => {
   align-items: center;
   justify-content: space-between;
   gap: 8px 16px;
-  margin: 8px 0 20px;
+  margin: 4px 0 12px;
 }
 
 .installation-methods :deep(.install-method .install-platforms) {
@@ -246,7 +262,7 @@ onUnmounted(() => {
   font-weight: 500;
 }
 
-.installation-methods :deep(.install-links p) {
+.installation-methods :deep(.install-method .install-links p) {
   display: flex;
   flex-wrap: wrap;
   gap: 6px;
@@ -275,8 +291,15 @@ onUnmounted(() => {
 }
 
 .installation-methods :deep(.install-method p) {
+  margin: 12px 0;
   font-size: 14px;
-  line-height: 24px;
+  line-height: 22px;
+}
+
+.installation-methods :deep(.installation-shortcuts + h2) {
+  margin-top: 24px;
+  padding-top: 0;
+  border-top: 0;
 }
 
 .installation-methods :deep(.install-method > :last-child) {
@@ -284,18 +307,21 @@ onUnmounted(() => {
 }
 
 .installation-methods :deep(.install-method div[class*='language-']) {
-  margin: 16px 0;
+  margin: 12px 0;
   border: 1px solid var(--vp-c-divider);
   border-radius: 8px;
 }
 
 .installation-methods :deep(.install-method div[class*='language-'] pre) {
-  padding: 16px 0;
+  padding: 14px 0;
+  overflow-x: auto;
+  overflow-y: hidden;
 }
 
 .installation-methods :deep(.install-method div[class*='language-'] code) {
   padding: 0 18px;
   font-size: 13px;
+  line-height: 22px;
 }
 
 .installation-methods :deep(.install-method .vp-code-group) {
@@ -330,36 +356,24 @@ onUnmounted(() => {
 }
 
 @media (max-width: 639px) {
-  :global(.installation-page .installation-shortcuts) {
-    grid-template-columns: 1fr;
-    gap: 8px;
-  }
-
-  :global(.installation-page .installation-shortcuts a) {
-    display: grid;
-    grid-template-columns: 24px 1fr;
-    column-gap: 12px;
-    padding: 12px 16px;
-  }
-
-  :global(.installation-page .installation-shortcuts span) {
-    grid-row: span 2;
-    align-self: center;
-    margin: 0;
+  .install-platform-buttons {
+    width: 100%;
   }
 
-  :global(.installation-page .installation-shortcuts small) {
-    margin-top: 0;
+  .install-platform-buttons button {
+    flex: 1;
+    padding: 8px 10px;
+    font-size: 13px;
   }
 
-  .install-platform-buttons {
-    display: grid;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    width: 100%;
+  .installation-methods :deep(.install-method) {
+    padding: 16px;
   }
+}
 
-  .installation-methods :deep(.install-method) {
-    padding: 20px 16px;
+@media (max-width: 379px) {
+  .install-platform-icon {
+    display: none;
   }
 }
 
diff --git a/website/src/latest/docs/installation.md b/website/src/latest/docs/installation.md
index e40b6ddf3a..b0b4ee5dcd 100644
--- a/website/src/latest/docs/installation.md
+++ b/website/src/latest/docs/installation.md
@@ -11,21 +11,19 @@ import InstallationMethods from '../../../.vitepress/components/InstallationMeth
 
 # Installation
 
-Install Task with your preferred package manager, download a binary, or set it
-up in CI. Then add shell completions and you're ready to go.
+Choose a package manager for your system, or install Task from a binary.
+
+<InstallationMethods>
 
 <nav class="installation-shortcuts" aria-label="Installation shortcuts">
-  <a href="#official-package-managers"><span>01</span><strong>Package managers</strong><small>Find your preferred method</small></a>
-  <a href="#get-the-binary"><span>02</span><strong>Binaries &amp; CI</strong><small>Downloads, scripts and actions</small></a>
-  <a href="#setup-completions"><span>03</span><strong>Shell completions</strong><small>Finish your setup</small></a>
+  <a href="#get-the-binary">Binaries &amp; CI</a>
+  <a href="#verify-installation">Verify installation</a>
+  <a href="#setup-completions">Shell completions</a>
 </nav>
 
-<InstallationMethods>
-
 ## Official packages {#official-package-managers}
 
-These installation methods are maintained by the Task team and are always
-up-to-date.
+Maintained by the Task team and kept up-to-date.
 
 <div class="install-method" data-platforms="macos">
 
@@ -45,14 +43,11 @@ up-to-date.
 
 </div>
 
-Task is available via our official Homebrew tap:
-
 ```shell
 brew install go-task/tap/go-task
 ```
 
-Alternatively it can be installed from the official Homebrew repository by
-running:
+Or use the Homebrew core formula:
 
 ```shell
 brew install go-task
@@ -82,7 +77,7 @@ Set up the repository:
 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
@@ -112,7 +107,7 @@ Set up the repository:
 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
@@ -136,13 +131,13 @@ apt install task
 
 </div>
 
-Set up the repository by running:
+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
@@ -166,14 +161,12 @@ apk add task
 
 </div>
 
-Task is available on [Snapcraft](https://snapcraft.io/task), but keep in mind
-that your Linux distribution should allow classic confinement for Snaps to Task
-work correctly:
-
 ```shell
 sudo snap install task --classic
 ```
 
+Requires a Linux distribution with classic confinement support.
+
 </div>
 
 <div class="install-method" data-platforms="macos linux windows">
@@ -193,13 +186,12 @@ sudo snap install task --classic
 
 </div>
 
-Npm can be used as cross-platform way to install Task globally or as a
-dependency of your project:
-
 ```shell
 npm install -g @go-task/cli
 ```
 
+Task is also available as a project dependency.
+
 </div>
 
 <div class="install-method" data-platforms="windows">
@@ -218,22 +210,21 @@ npm install -g @go-task/cli
 
 </div>
 
-Task is available via the
-[community repository](https://github.com/microsoft/winget-pkgs):
-
 ```shell
 winget install Task.Task
 ```
 
+Available through the
+[WinGet community repository](https://github.com/microsoft/winget-pkgs).
+
 </div>
 
 <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}
 
-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.
+Maintained by the community, outside the Task team's control. These packages may
+lag behind the latest release.
 
 <div class="install-method" data-platforms="macos linux windows">
 
@@ -251,14 +242,12 @@ these packages.
 
 </div>
 
-Install and activate Task globally with Mise:
-
 ```shell
 mise use -g task
 ```
 
-To use Task in the current project instead, run `mise use task`. This installs
-Task and adds it to your project's `mise.toml`.
+For a project-local installation, use `mise use task` instead. This adds Task to
+your project's `mise.toml`.
 
 </div>
 
@@ -279,8 +268,6 @@ Task and adds it to your project's `mise.toml`.
 
 </div>
 
-Task repository is tracked by Macports:
-
 ```shell
 port install go-task
 ```
@@ -304,8 +291,6 @@ port install go-task
 
 </div>
 
-Like npm, pip can be used as a cross-platform way to install Task:
-
 ```shell
 pip install go-task-bin
 ```
@@ -616,6 +601,19 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
+## 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
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index e40b6ddf3a..b0b4ee5dcd 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -11,21 +11,19 @@ import InstallationMethods from '../../../.vitepress/components/InstallationMeth
 
 # Installation
 
-Install Task with your preferred package manager, download a binary, or set it
-up in CI. Then add shell completions and you're ready to go.
+Choose a package manager for your system, or install Task from a binary.
+
+<InstallationMethods>
 
 <nav class="installation-shortcuts" aria-label="Installation shortcuts">
-  <a href="#official-package-managers"><span>01</span><strong>Package managers</strong><small>Find your preferred method</small></a>
-  <a href="#get-the-binary"><span>02</span><strong>Binaries &amp; CI</strong><small>Downloads, scripts and actions</small></a>
-  <a href="#setup-completions"><span>03</span><strong>Shell completions</strong><small>Finish your setup</small></a>
+  <a href="#get-the-binary">Binaries &amp; CI</a>
+  <a href="#verify-installation">Verify installation</a>
+  <a href="#setup-completions">Shell completions</a>
 </nav>
 
-<InstallationMethods>
-
 ## Official packages {#official-package-managers}
 
-These installation methods are maintained by the Task team and are always
-up-to-date.
+Maintained by the Task team and kept up-to-date.
 
 <div class="install-method" data-platforms="macos">
 
@@ -45,14 +43,11 @@ up-to-date.
 
 </div>
 
-Task is available via our official Homebrew tap:
-
 ```shell
 brew install go-task/tap/go-task
 ```
 
-Alternatively it can be installed from the official Homebrew repository by
-running:
+Or use the Homebrew core formula:
 
 ```shell
 brew install go-task
@@ -82,7 +77,7 @@ Set up the repository:
 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
@@ -112,7 +107,7 @@ Set up the repository:
 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
@@ -136,13 +131,13 @@ apt install task
 
 </div>
 
-Set up the repository by running:
+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
@@ -166,14 +161,12 @@ apk add task
 
 </div>
 
-Task is available on [Snapcraft](https://snapcraft.io/task), but keep in mind
-that your Linux distribution should allow classic confinement for Snaps to Task
-work correctly:
-
 ```shell
 sudo snap install task --classic
 ```
 
+Requires a Linux distribution with classic confinement support.
+
 </div>
 
 <div class="install-method" data-platforms="macos linux windows">
@@ -193,13 +186,12 @@ sudo snap install task --classic
 
 </div>
 
-Npm can be used as cross-platform way to install Task globally or as a
-dependency of your project:
-
 ```shell
 npm install -g @go-task/cli
 ```
 
+Task is also available as a project dependency.
+
 </div>
 
 <div class="install-method" data-platforms="windows">
@@ -218,22 +210,21 @@ npm install -g @go-task/cli
 
 </div>
 
-Task is available via the
-[community repository](https://github.com/microsoft/winget-pkgs):
-
 ```shell
 winget install Task.Task
 ```
 
+Available through the
+[WinGet community repository](https://github.com/microsoft/winget-pkgs).
+
 </div>
 
 <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}
 
-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.
+Maintained by the community, outside the Task team's control. These packages may
+lag behind the latest release.
 
 <div class="install-method" data-platforms="macos linux windows">
 
@@ -251,14 +242,12 @@ these packages.
 
 </div>
 
-Install and activate Task globally with Mise:
-
 ```shell
 mise use -g task
 ```
 
-To use Task in the current project instead, run `mise use task`. This installs
-Task and adds it to your project's `mise.toml`.
+For a project-local installation, use `mise use task` instead. This adds Task to
+your project's `mise.toml`.
 
 </div>
 
@@ -279,8 +268,6 @@ Task and adds it to your project's `mise.toml`.
 
 </div>
 
-Task repository is tracked by Macports:
-
 ```shell
 port install go-task
 ```
@@ -304,8 +291,6 @@ port install go-task
 
 </div>
 
-Like npm, pip can be used as a cross-platform way to install Task:
-
 ```shell
 pip install go-task-bin
 ```
@@ -616,6 +601,19 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
+## 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

From a27d38e18e80e190a5127c290aa4a0e991d1805a Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:22:50 +0200
Subject: [PATCH 03/12] fix(docs): prevent code block scrollbars

---
 website/.vitepress/components/InstallationMethods.vue | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 78caba656e..2ad0db0364 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -324,6 +324,13 @@ onUnmounted(() => {
   line-height: 22px;
 }
 
+/* Keep the 40px copy control inside the compact, 50px single-line block. */
+.installation-methods
+  :deep(.install-method div[class*='language-'] > button.copy) {
+  top: 5px;
+  right: 6px;
+}
+
 .installation-methods :deep(.install-method .vp-code-group) {
   margin-top: 16px;
 }

From 557298648584ae66badc10cf1ea8f92d61720ddc Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:24:25 +0200
Subject: [PATCH 04/12] fix(docs): make installation shortcuts more visible

---
 .../.vitepress/components/InstallationMethods.vue    | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 2ad0db0364..9770c92c2b 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -132,16 +132,18 @@ onUnmounted(() => {
 
 :global(.installation-page .installation-shortcuts a) {
   padding: 4px 0;
-  color: var(--vp-c-text-2);
+  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: none;
+  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-brand-1);
-  text-decoration: underline;
-  text-underline-offset: 4px;
+  color: var(--vp-c-text-1);
+  text-decoration-color: currentColor;
 }
 
 :global(.installation-page .installation-shortcuts a:focus-visible) {

From 6bd31498fd4bb26153b20913155f089041046a16 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:26:19 +0200
Subject: [PATCH 05/12] fix(docs): show code scrollbars on hover

---
 .../components/InstallationMethods.vue        | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 9770c92c2b..4c1939b6db 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -318,6 +318,41 @@ onUnmounted(() => {
   padding: 14px 0;
   overflow-x: auto;
   overflow-y: hidden;
+  scrollbar-width: thin;
+  scrollbar-color: transparent transparent;
+}
+
+.installation-methods :deep(.install-method div[class*='language-']:hover pre),
+.installation-methods
+  :deep(.install-method div[class*='language-']:focus-within pre) {
+  scrollbar-color: var(--vp-c-text-3) transparent;
+}
+
+/* Fallback for browsers without scrollbar-color support. */
+.installation-methods :deep(.install-method pre::-webkit-scrollbar) {
+  height: 6px;
+}
+
+.installation-methods :deep(.install-method pre::-webkit-scrollbar-track),
+.installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+  background: transparent;
+}
+
+.installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+  border-radius: 3px;
+}
+
+.installation-methods
+  :deep(
+    .install-method div[class*='language-']:hover pre::-webkit-scrollbar-thumb
+  ),
+.installation-methods
+  :deep(
+    .install-method
+      div[class*='language-']:focus-within
+      pre::-webkit-scrollbar-thumb
+  ) {
+  background: var(--vp-c-text-3);
 }
 
 .installation-methods :deep(.install-method div[class*='language-'] code) {
@@ -386,6 +421,16 @@ onUnmounted(() => {
   }
 }
 
+@media (hover: none), (forced-colors: active) {
+  .installation-methods :deep(.install-method div[class*='language-'] pre) {
+    scrollbar-color: auto;
+  }
+
+  .installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+    background: var(--vp-c-text-3);
+  }
+}
+
 @media print {
   .install-picker {
     display: none;

From 8401f7da32b3e19d4278e2db28aad8c1bfa9a209 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:36:37 +0200
Subject: [PATCH 06/12] docs: add package manager icons to installation cards

---
 .../components/InstallationMethods.vue        | 73 ++++++++++++++++++-
 .../theme/icons/install/alpinelinux.svg       |  4 +
 .../theme/icons/install/archlinux.svg         |  4 +
 .../theme/icons/install/chocolatey.svg        |  4 +
 .../.vitepress/theme/icons/install/fedora.svg |  5 ++
 .../theme/icons/install/freebsd.svg           |  4 +
 .../theme/icons/install/homebrew.svg          |  4 +
 .../.vitepress/theme/icons/install/mise.svg   | 31 ++++++++
 .../.vitepress/theme/icons/install/nixos.svg  |  4 +
 .../.vitepress/theme/icons/install/npm.svg    |  4 +
 .../theme/icons/install/package.svg           |  3 +
 .../.vitepress/theme/icons/install/python.svg |  4 +
 .../theme/icons/install/snapcraft.svg         |  5 ++
 13 files changed, 148 insertions(+), 1 deletion(-)
 create mode 100644 website/.vitepress/theme/icons/install/alpinelinux.svg
 create mode 100644 website/.vitepress/theme/icons/install/archlinux.svg
 create mode 100644 website/.vitepress/theme/icons/install/chocolatey.svg
 create mode 100644 website/.vitepress/theme/icons/install/fedora.svg
 create mode 100644 website/.vitepress/theme/icons/install/freebsd.svg
 create mode 100644 website/.vitepress/theme/icons/install/homebrew.svg
 create mode 100644 website/.vitepress/theme/icons/install/mise.svg
 create mode 100644 website/.vitepress/theme/icons/install/nixos.svg
 create mode 100644 website/.vitepress/theme/icons/install/npm.svg
 create mode 100644 website/.vitepress/theme/icons/install/package.svg
 create mode 100644 website/.vitepress/theme/icons/install/python.svg
 create mode 100644 website/.vitepress/theme/icons/install/snapcraft.svg

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 4c1939b6db..4abfd38e30 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -232,12 +232,83 @@ onUnmounted(() => {
 }
 
 .installation-methods :deep(.install-method h3) {
+  position: relative;
   margin: 0 0 4px;
-  padding: 0;
+  padding: 0 0 0 30px;
   font-size: 18px;
   line-height: 26px;
 }
 
+/* Decorative CSS masks keep logos out of heading names and the page outline. */
+.installation-methods :deep(.install-method 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;
+}
+
+.installation-methods :deep(#homebrew) {
+  --install-icon: url('../theme/icons/install/homebrew.svg');
+  --install-icon-color: #fbb040;
+}
+
+.installation-methods :deep(#apk) {
+  --install-icon: url('../theme/icons/install/alpinelinux.svg');
+  --install-icon-color: #0d597f;
+}
+
+.installation-methods :deep(#snap) {
+  --install-icon: url('../theme/icons/install/snapcraft.svg');
+  --install-icon-color: #e95420;
+}
+
+.installation-methods :deep(#npm) {
+  --install-icon: url('../theme/icons/install/npm.svg');
+  --install-icon-color: #cb3837;
+}
+
+.installation-methods :deep(#mise) {
+  --install-icon: url('../theme/icons/install/mise.svg');
+  --install-icon-color: var(--vp-c-text-1);
+}
+
+.installation-methods :deep(#pip) {
+  --install-icon: url('../theme/icons/install/python.svg');
+  --install-icon-color: #3776ab;
+}
+
+.installation-methods :deep(#chocolatey) {
+  --install-icon: url('../theme/icons/install/chocolatey.svg');
+  --install-icon-color: #80b5e3;
+}
+
+.installation-methods :deep(#arch) {
+  --install-icon: url('../theme/icons/install/archlinux.svg');
+  --install-icon-color: #1793d1;
+}
+
+.installation-methods :deep(#fedora-community) {
+  --install-icon: url('../theme/icons/install/fedora.svg');
+  --install-icon-color: #51a2da;
+}
+
+.installation-methods :deep(#freebsd) {
+  --install-icon: url('../theme/icons/install/freebsd.svg');
+  --install-icon-color: #ab2b28;
+}
+
+.installation-methods :deep(#nix) {
+  --install-icon: url('../theme/icons/install/nixos.svg');
+  --install-icon-color: #5277c3;
+}
+
 .installation-methods :deep(.install-method h3 a:not(.header-anchor)) {
   color: var(--vp-c-text-1);
   text-decoration: none;
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>

From 6c04d98917480aa024f82a757a29990918734d23 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:38:05 +0200
Subject: [PATCH 07/12] fix(docs): hide overlapping installation code labels

---
 website/.vitepress/components/InstallationMethods.vue | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index 4abfd38e30..dfa4365e68 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -385,6 +385,12 @@ onUnmounted(() => {
   border-radius: 8px;
 }
 
+/* Compact commands leave no room for the overlaid language label. */
+.installation-methods
+  :deep(.install-method div[class*='language-'] > span.lang) {
+  display: none;
+}
+
 .installation-methods :deep(.install-method div[class*='language-'] pre) {
   padding: 14px 0;
   overflow-x: auto;

From 342e89f1bab101107355414f8a021172b4ad203b Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:45:17 +0200
Subject: [PATCH 08/12] docs: clarify binary and CI installation options

---
 website/src/latest/docs/installation.md | 84 ++++++++++++++-----------
 website/src/next/docs/installation.md   | 84 ++++++++++++++-----------
 2 files changed, 94 insertions(+), 74 deletions(-)

diff --git a/website/src/latest/docs/installation.md b/website/src/latest/docs/installation.md
index b0b4ee5dcd..ec77b9aa19 100644
--- a/website/src/latest/docs/installation.md
+++ b/website/src/latest/docs/installation.md
@@ -489,72 +489,82 @@ task
 
 ## Binaries & CI {#get-the-binary}
 
-### Binary
+Install Task without a package manager: download a binary, use the install
+script, or add the setup action to your GitHub workflow.
 
-You can download the binary from the
-[releases page on GitHub](https://github.com/go-task/task/releases) and add to
-your `$PATH`.
+### Download a binary {#binary}
 
-DEB, RPM and APK packages are also available.
+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`.
 
-The `task_checksums.txt` file contains the SHA-256 checksum for each file.
+Each release also includes DEB, RPM and APK packages, plus `task_checksums.txt`
+with SHA-256 checksums for the release files.
 
-### Install Script
+### Install with a script {#install-script}
 
-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.
+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, it installs on the `./bin` directory relative to the working
-directory:
+By default, the script installs the latest release into `./bin`, relative to
+your current directory. Choose a different directory or pin a release:
 
-```shell
+::: 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
-
-On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by
-default.
+```shell [Pinned version]
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d 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:
+Use `-b` to set the destination and a
+[release tag](https://github.com/go-task/task/releases) to choose the version.
+To combine them, put the directory option before the tag:
 
 ```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.36.0
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
 ```
 
-Parameters are order specific, to set both installation directory and version:
+::: tip Make Task available in your shell
 
-```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
-```
+Add the installation directory to your `PATH` to run `task` from anywhere. With
+the default location, you can also run `./bin/task` directly.
+
+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
 ```
 
+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
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index b0b4ee5dcd..ec77b9aa19 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -489,72 +489,82 @@ task
 
 ## Binaries & CI {#get-the-binary}
 
-### Binary
+Install Task without a package manager: download a binary, use the install
+script, or add the setup action to your GitHub workflow.
 
-You can download the binary from the
-[releases page on GitHub](https://github.com/go-task/task/releases) and add to
-your `$PATH`.
+### Download a binary {#binary}
 
-DEB, RPM and APK packages are also available.
+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`.
 
-The `task_checksums.txt` file contains the SHA-256 checksum for each file.
+Each release also includes DEB, RPM and APK packages, plus `task_checksums.txt`
+with SHA-256 checksums for the release files.
 
-### Install Script
+### Install with a script {#install-script}
 
-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.
+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, it installs on the `./bin` directory relative to the working
-directory:
+By default, the script installs the latest release into `./bin`, relative to
+your current directory. Choose a different directory or pin a release:
 
-```shell
+::: 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
-
-On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by
-default.
+```shell [Pinned version]
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d 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:
+Use `-b` to set the destination and a
+[release tag](https://github.com/go-task/task/releases) to choose the version.
+To combine them, put the directory option before the tag:
 
 ```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.36.0
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
 ```
 
-Parameters are order specific, to set both installation directory and version:
+::: tip Make Task available in your shell
 
-```shell
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
-```
+Add the installation directory to your `PATH` to run `task` from anywhere. With
+the default location, you can also run `./bin/task` directly.
+
+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
 ```
 
+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

From 4f8bcf8be00e761f81750bf7ac895b435b64f051 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:48:05 +0200
Subject: [PATCH 09/12] fix(docs): extend hover scrollbars across installation
 page

---
 .../components/InstallationMethods.vue        | 46 +++++++++++--------
 1 file changed, 27 insertions(+), 19 deletions(-)

diff --git a/website/.vitepress/components/InstallationMethods.vue b/website/.vitepress/components/InstallationMethods.vue
index dfa4365e68..c76d57452c 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -393,42 +393,48 @@ onUnmounted(() => {
 
 .installation-methods :deep(.install-method div[class*='language-'] pre) {
   padding: 14px 0;
+}
+
+:global(.installation-page div[class*='language-'] pre) {
   overflow-x: auto;
   overflow-y: hidden;
   scrollbar-width: thin;
   scrollbar-color: transparent transparent;
 }
 
-.installation-methods :deep(.install-method div[class*='language-']:hover pre),
-.installation-methods
-  :deep(.install-method div[class*='language-']:focus-within pre) {
+: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. */
-.installation-methods :deep(.install-method pre::-webkit-scrollbar) {
+:global(.installation-page div[class*='language-'] pre::-webkit-scrollbar) {
   height: 6px;
 }
 
-.installation-methods :deep(.install-method pre::-webkit-scrollbar-track),
-.installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-track
+),
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+) {
   background: transparent;
 }
 
-.installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+:global(
+  .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+) {
   border-radius: 3px;
 }
 
-.installation-methods
-  :deep(
-    .install-method div[class*='language-']:hover pre::-webkit-scrollbar-thumb
-  ),
-.installation-methods
-  :deep(
-    .install-method
-      div[class*='language-']:focus-within
-      pre::-webkit-scrollbar-thumb
-  ) {
+: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);
 }
 
@@ -499,11 +505,13 @@ onUnmounted(() => {
 }
 
 @media (hover: none), (forced-colors: active) {
-  .installation-methods :deep(.install-method div[class*='language-'] pre) {
+  :global(.installation-page div[class*='language-'] pre) {
     scrollbar-color: auto;
   }
 
-  .installation-methods :deep(.install-method pre::-webkit-scrollbar-thumb) {
+  :global(
+    .installation-page div[class*='language-'] pre::-webkit-scrollbar-thumb
+  ) {
     background: var(--vp-c-text-3);
   }
 }

From eb109d7dd375c47f1d324a05020a20161b9f9a72 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Mon, 7 Sep 2026 11:50:01 +0200
Subject: [PATCH 10/12] docs: group combined installation script options

---
 website/src/latest/docs/installation.md | 13 ++++++-------
 website/src/next/docs/installation.md   | 13 ++++++-------
 2 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/website/src/latest/docs/installation.md b/website/src/latest/docs/installation.md
index ec77b9aa19..562b78f9bf 100644
--- a/website/src/latest/docs/installation.md
+++ b/website/src/latest/docs/installation.md
@@ -526,16 +526,15 @@ sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.42.1
 ```
 
-:::
-
-Use `-b` to set the destination and a
-[release tag](https://github.com/go-task/task/releases) to choose the version.
-To combine them, put the directory option before the tag:
-
-```shell
+```shell [Directory + version]
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
 ```
 
+:::
+
+When combining options, keep the
+[release tag](https://github.com/go-task/task/releases) last.
+
 ::: tip Make Task available in your shell
 
 Add the installation directory to your `PATH` to run `task` from anywhere. With
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index ec77b9aa19..562b78f9bf 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -526,16 +526,15 @@ sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.42.1
 ```
 
-:::
-
-Use `-b` to set the destination and a
-[release tag](https://github.com/go-task/task/releases) to choose the version.
-To combine them, put the directory option before the tag:
-
-```shell
+```shell [Directory + version]
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
 ```
 
+:::
+
+When combining options, keep the
+[release tag](https://github.com/go-task/task/releases) last.
+
 ::: tip Make Task available in your shell
 
 Add the installation directory to your `PATH` to run `task` from anywhere. With

From 6914460c73a4b35ed5cead8a1ba6ab3a76cc35fd Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Tue, 8 Sep 2026 22:21:27 +0200
Subject: [PATCH 11/12] docs: limit installation redesign to next channel

---
 website/src/latest/docs/installation.md | 569 +++++++-----------------
 1 file changed, 154 insertions(+), 415 deletions(-)

diff --git a/website/src/latest/docs/installation.md b/website/src/latest/docs/installation.md
index 562b78f9bf..bcf568b8ae 100644
--- a/website/src/latest/docs/installation.md
+++ b/website/src/latest/docs/installation.md
@@ -2,476 +2,243 @@
 title: Installation
 description: Installation methods for Task
 outline: deep
-pageClass: installation-page
 ---
 
-<script setup>
-import InstallationMethods from '../../../.vitepress/components/InstallationMethods.vue';
-</script>
-
 # Installation
 
-Choose a package manager for your system, or install Task from a binary.
-
-<InstallationMethods>
-
-<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>
-
-## Official packages {#official-package-managers}
-
-Maintained by the Task team and kept up-to-date.
-
-<div class="install-method" data-platforms="macos">
-
-### [Homebrew](https://brew.sh) {#homebrew}
-
-<div class="install-meta">
-
-<p class="install-platforms">macOS</p>
-
-<div class="install-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)
-
-</div>
-
-</div>
-
-```shell
-brew install go-task/tap/go-task
-```
-
-Or use the Homebrew core formula:
-
-```shell
-brew install go-task
-```
-
-</div>
+Task offers many installation methods. Check out the available methods below.
 
-<div class="install-method" data-platforms="linux">
+## Official Package Managers
 
-### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
+These installation methods are maintained by the Task team and are always
+up-to-date.
 
-<div class="install-meta">
+:::info Package Repository Hosting
 
-<p class="install-platforms">Fedora · CentOS · Red Hat</p>
+[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=for-the-badge)](https://cloudsmith.com)
 
-<div class="install-links">
+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.
 
-[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)
+:::
 
-</div>
+### [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}
 
-</div>
+[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)]
 
-Set up the repository:
+If you Set up the repository by running :
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.rpm.sh' | sudo -E bash
 ```
 
-Install Task:
+Then you can install Task with:
 
 ```shell
 dnf install task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
-
-### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
-
-<div class="install-meta">
+### [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}
 
-<p class="install-platforms">Ubuntu · Debian · Linux Mint</p>
+[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)]
 
-<div class="install-links">
-
-[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)
-
-</div>
-
-</div>
-
-Set up the repository:
+If you Set up the repository by running:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.deb.sh' | sudo -E bash
 ```
 
-Install Task:
+Then you can install Task with:
 
 ```shell
 apt install task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
+### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) ![Alpine Linux](https://img.shields.io/badge/Alpine_Linux-0D597F?logo=alpinelinux&logoColor=fff) {#apk}
 
-### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
+[[package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)]
 
-<div class="install-meta">
-
-<p class="install-platforms">Alpine Linux</p>
-
-<div class="install-links">
-
-[View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)
-
-</div>
-
-</div>
-
-Set up the repository:
+Set up the repository by running:
 
 ```shell
 curl -1sLf 'https://dl.cloudsmith.io/public/task/task/setup.alpine.sh' | sudo -E bash
 ```
 
-Install Task:
+Then you can install Task with:
 
 ```shell
 apk add task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
-
-### [Snap](https://snapcraft.io/task) {#snap}
+### [Homebrew](https://brew.sh) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#homebrew}
 
-<div class="install-meta">
+Task is available via our official Homebrew tap
+[[source](https://github.com/go-task/homebrew-tap/blob/main/Casks/go-task.rb)]:
 
-<p class="install-platforms">Linux</p>
+```shell
+brew install go-task/tap/go-task
+```
 
-<div class="install-links">
+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:
 
-[Source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)
+```shell
+brew install go-task
+```
 
-</div>
+### [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}
 
-</div>
+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:
 
 ```shell
 sudo snap install task --classic
 ```
 
-Requires a Linux distribution with classic confinement support.
-
-</div>
-
-<div class="install-method" data-platforms="macos linux windows">
-
-### [npm](https://www.npmjs.com) {#npm}
-
-<div class="install-meta">
-
-<p class="install-platforms">macOS · Linux · Windows</p>
-
-<div class="install-links">
-
-[View package](https://www.npmjs.com/package/@go-task/cli)
-[Source](https://github.com/go-task/task/blob/main/package.json)
+### [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}
 
-</div>
-
-</div>
+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)]:
 
 ```shell
 npm install -g @go-task/cli
 ```
 
-Task is also available as a project dependency.
-
-</div>
-
-<div class="install-method" data-platforms="windows">
-
-### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
-
-<div class="install-meta">
+### [WinGet](https://github.com/microsoft/winget-cli) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#winget}
 
-<p class="install-platforms">Windows</p>
-
-<div class="install-links">
-
-[Source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)
-
-</div>
-
-</div>
+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)]:
 
 ```shell
 winget install Task.Task
 ```
 
-Available through the
-[WinGet community repository](https://github.com/microsoft/winget-pkgs).
-
-</div>
+## Community-Maintained Package Managers
 
-<p class="install-hosting">Package repository hosting for deb/rpm/apk is graciously provided by <a href="https://cloudsmith.com">Cloudsmith</a>.</p>
+::: warning Community Maintained
 
-## Community packages {#community-maintained-package-managers}
+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.
 
-Maintained by the community, outside the Task team's control. These packages may
-lag behind the latest release.
-
-<div class="install-method" data-platforms="macos linux windows">
-
-### [Mise](https://mise.jdx.dev/) {#mise}
-
-<div class="install-meta">
-
-<p class="install-platforms">macOS · Linux · Windows</p>
+:::
 
-<div class="install-links">
+### [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}
 
-[View package](https://mise-tools.jdx.dev/tools/task)
+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`.
 
-</div>
+If using Mise, we recommend using the `aqua` or `ubi` backends to install Task
+as these install directly from our GitHub releases.
 
-</div>
+::: code-group
 
-```shell
-mise use -g task
+```shell [aqua]
+mise use -g aqua:go-task/task@latest
+mise install
 ```
 
-For a project-local installation, use `mise use task` instead. This adds Task to
-your project's `mise.toml`.
-
-</div>
-
-<div class="install-method" data-platforms="macos">
-
-### [Macports](https://macports.org) {#macports}
-
-<div class="install-meta">
-
-<p class="install-platforms">macOS</p>
-
-<div class="install-links">
+```shell [ubi]
+mise use -g ubi:go-task/task
+mise install
+```
 
-[View package](https://ports.macports.org/port/go-task/details/)
-[Source](https://github.com/macports/macports-ports/blob/master/devel/go-task/Portfile)
+:::
 
-</div>
+### [Macports](https://macports.org) ![macOS](https://img.shields.io/badge/MacOS-000000?logo=apple&logoColor=F0F0F0) {#macports}
 
-</div>
+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)]:
 
 ```shell
 port install go-task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="macos linux windows">
-
-### [pip](https://pip.pypa.io) {#pip}
-
-<div class="install-meta">
-
-<p class="install-platforms">macOS · Linux · Windows</p>
-
-<div class="install-links">
-
-[View package](https://pypi.org/project/go-task-bin)
-[Source](https://github.com/Bing-su/pip-binary-factory/tree/main/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}
 
-</div>
-
-</div>
+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)]:
 
 ```shell
 pip install go-task-bin
 ```
 
-</div>
-
-<div class="install-method" data-platforms="windows">
-
-### [Chocolatey](https://chocolatey.org) {#chocolatey}
-
-<div class="install-meta">
-
-<p class="install-platforms">Windows</p>
-
-<div class="install-links">
+### [Chocolatey](https://chocolatey.org) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#chocolatey}
 
-[View package](https://community.chocolatey.org/packages/go-task)
-[Source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)
-
-</div>
-
-</div>
+[[package](https://community.chocolatey.org/packages/go-task)]
+[[source](https://github.com/Starz0r/ChocolateyPackagingScripts/blob/master/src/go-task_gh_build.py)]
 
 ```shell
 choco install go-task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="windows">
-
-### [Scoop](https://scoop.sh) {#scoop}
-
-<div class="install-meta">
+### [Scoop](https://scoop.sh) ![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white) {#scoop}
 
-<p class="install-platforms">Windows</p>
-
-<div class="install-links">
-
-[Source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)
-
-</div>
-
-</div>
+[[source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)]
 
 ```shell
 scoop install task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
-
-### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
-
-<div class="install-meta">
-
-<p class="install-platforms">Arch Linux</p>
-
-<div class="install-links">
-
-[View package](https://archlinux.org/packages/extra/x86_64/go-task/)
-[Source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-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}
 
-</div>
-
-</div>
+[[package](https://archlinux.org/packages/extra/x86_64/go-task/)]
+[[source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)]
 
 ```shell
 pacman -S go-task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
-
-### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
-
-<div class="install-meta">
-
-<p class="install-platforms">Fedora</p>
-
-<div class="install-links">
+### 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}
 
-[View package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
-[Source](https://src.fedoraproject.org/rpms/golang-github-task)
-
-</div>
-
-</div>
+[[package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)]
+[[source](https://src.fedoraproject.org/rpms/golang-github-task)]
 
 ```shell
 dnf install go-task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="freebsd">
-
-### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
-
-<div class="install-meta">
+### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) ![FreeBSD](https://img.shields.io/badge/FreeBSD-990000?logo=freebsd&logoColor=fff) {#freebsd}
 
-<p class="install-platforms">FreeBSD</p>
-
-<div class="install-links">
-
-[View package](https://cgit.freebsd.org/ports/tree/devel/task)
-[Source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)
-
-</div>
-
-</div>
+[[package](https://cgit.freebsd.org/ports/tree/devel/task)]
+[[source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)]
 
 ```shell
 pkg install task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux macos">
-
-### [Nix](https://nixos.org) {#nix}
-
-<div class="install-meta">
-
-<p class="install-platforms">Nix · NixOS · Linux · macOS</p>
-
-<div class="install-links">
-
-[Source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)
+### [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}
 
-</div>
-
-</div>
+[[source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)]
 
 ```shell
 nix-env -iA nixpkgs.go-task
 ```
 
-</div>
-
-<div class="install-method" data-platforms="linux">
-
-### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
-
-<div class="install-meta">
-
-<p class="install-platforms">Debian · Ubuntu</p>
-
-<div class="install-links">
+### [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}
 
-[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)
-
-</div>
-
-</div>
+[[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)]
 
 ```shell
 pacstall -I go-task-deb
 ```
 
-</div>
-
-<div class="install-method" data-platforms="macos linux">
-
-### [pkgx](https://pkgx.sh) {#pkgx}
-
-<div class="install-meta">
+### [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}
 
-<p class="install-platforms">macOS · Linux</p>
-
-<div class="install-links">
-
-[View package](https://pkgx.dev/pkgs/taskfile.dev)
-[Source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)
-
-</div>
-
-</div>
+[[package](https://pkgx.dev/pkgs/taskfile.dev)]
+[[source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)]
 
 ```shell
 pkgx task
@@ -483,88 +250,75 @@ or, if you have pkgx integration enabled:
 task
 ```
 
-</div>
-
-</InstallationMethods>
+## Get The Binary
 
-## Binaries & CI {#get-the-binary}
+### Binary
 
-Install Task without a package manager: download a binary, use the install
-script, or add the setup action to your GitHub workflow.
+You can download the binary from the
+[releases page on GitHub](https://github.com/go-task/task/releases) and add to
+your `$PATH`.
 
-### Download a binary {#binary}
+DEB, RPM and APK packages are also available.
 
-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`.
+The `task_checksums.txt` file contains the SHA-256 checksum for each file.
 
-Each release also includes DEB, RPM and APK packages, plus `task_checksums.txt`
-with SHA-256 checksums for the release files.
+### Install Script
 
-### Install with a script {#install-script}
+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.
 
-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, it installs on the `./bin` directory relative to the working
+directory:
 
-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]
+```shell
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d
 ```
 
-```shell [Custom directory]
+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
 sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
 ```
 
-```shell [Pinned version]
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d v3.42.1
-```
+::: warning
 
-```shell [Directory + version]
-sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
-```
+On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by
+default.
 
 :::
 
-When combining options, keep the
-[release tag](https://github.com/go-task/task/releases) last.
-
-::: tip Make Task available in your shell
+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:
 
-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 v3.36.0
+```
 
-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.
+Parameters are order specific, to set both installation directory and version:
 
-:::
+```shell
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin v3.42.1
+```
 
 ### GitHub Actions
 
-Add the [official setup action](https://github.com/go-task/setup-task) to your
-job's `steps` before running Task:
+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.
 
 ```yaml
 - name: Install Task
-  uses: go-task/setup-task@v2
-
-- name: Verify Task
-  run: task --version
+  uses: go-task/setup-task@v1
 ```
 
-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
+## 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
@@ -610,20 +364,7 @@ demand before calling it.
 go tool task {arguments...}
 ```
 
-## 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}
+## 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
@@ -635,8 +376,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
 
@@ -705,10 +446,9 @@ 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
@@ -723,19 +463,18 @@ 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`.

From b512e53e4fe8175a2bc86594fd0f3e56e9940ed7 Mon Sep 17 00:00:00 2001
From: Valentin Maerten <maerten.valentin@gmail.com>
Date: Wed, 9 Sep 2026 22:10:09 +0200
Subject: [PATCH 12/12] refactor(docs): extract shared installation method
 component

---
 .../components/InstallationMethod.vue         | 226 ++++++++++++++
 .../components/InstallationMethods.vue        | 204 -------------
 website/src/next/docs/installation.md         | 289 ++++++++----------
 3 files changed, 353 insertions(+), 366 deletions(-)
 create mode 100644 website/.vitepress/components/InstallationMethod.vue

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
index c76d57452c..6b114bf1dd 100644
--- a/website/.vitepress/components/InstallationMethods.vue
+++ b/website/.vitepress/components/InstallationMethods.vue
@@ -222,179 +222,12 @@ onUnmounted(() => {
   white-space: nowrap;
 }
 
-.installation-methods :deep(.install-method) {
-  position: relative;
-  margin: 16px 0;
-  padding: 20px;
-  border: 1px solid var(--vp-c-divider);
-  border-radius: 12px;
-  background: var(--vp-c-bg);
-}
-
-.installation-methods :deep(.install-method 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. */
-.installation-methods :deep(.install-method 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;
-}
-
-.installation-methods :deep(#homebrew) {
-  --install-icon: url('../theme/icons/install/homebrew.svg');
-  --install-icon-color: #fbb040;
-}
-
-.installation-methods :deep(#apk) {
-  --install-icon: url('../theme/icons/install/alpinelinux.svg');
-  --install-icon-color: #0d597f;
-}
-
-.installation-methods :deep(#snap) {
-  --install-icon: url('../theme/icons/install/snapcraft.svg');
-  --install-icon-color: #e95420;
-}
-
-.installation-methods :deep(#npm) {
-  --install-icon: url('../theme/icons/install/npm.svg');
-  --install-icon-color: #cb3837;
-}
-
-.installation-methods :deep(#mise) {
-  --install-icon: url('../theme/icons/install/mise.svg');
-  --install-icon-color: var(--vp-c-text-1);
-}
-
-.installation-methods :deep(#pip) {
-  --install-icon: url('../theme/icons/install/python.svg');
-  --install-icon-color: #3776ab;
-}
-
-.installation-methods :deep(#chocolatey) {
-  --install-icon: url('../theme/icons/install/chocolatey.svg');
-  --install-icon-color: #80b5e3;
-}
-
-.installation-methods :deep(#arch) {
-  --install-icon: url('../theme/icons/install/archlinux.svg');
-  --install-icon-color: #1793d1;
-}
-
-.installation-methods :deep(#fedora-community) {
-  --install-icon: url('../theme/icons/install/fedora.svg');
-  --install-icon-color: #51a2da;
-}
-
-.installation-methods :deep(#freebsd) {
-  --install-icon: url('../theme/icons/install/freebsd.svg');
-  --install-icon-color: #ab2b28;
-}
-
-.installation-methods :deep(#nix) {
-  --install-icon: url('../theme/icons/install/nixos.svg');
-  --install-icon-color: #5277c3;
-}
-
-.installation-methods :deep(.install-method h3 a:not(.header-anchor)) {
-  color: var(--vp-c-text-1);
-  text-decoration: none;
-}
-
-.installation-methods :deep(.install-method h3 a:hover) {
-  color: var(--vp-c-brand-1);
-}
-
-.installation-methods :deep(.install-meta) {
-  display: flex;
-  flex-wrap: wrap;
-  align-items: center;
-  justify-content: space-between;
-  gap: 8px 16px;
-  margin: 4px 0 12px;
-}
-
-.installation-methods :deep(.install-method .install-platforms) {
-  margin: 0;
-  color: var(--vp-c-text-2);
-  font-size: 12px;
-  line-height: 20px;
-  font-weight: 500;
-}
-
-.installation-methods :deep(.install-method .install-links p) {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 6px;
-  margin: 0;
-}
-
-.installation-methods :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;
-}
-
-.installation-methods :deep(.install-links a:hover) {
-  border-color: var(--vp-c-brand-1);
-}
-
-.installation-methods :deep(.install-links a:focus-visible) {
-  outline: 2px solid var(--vp-c-brand-1);
-  outline-offset: 2px;
-}
-
-.installation-methods :deep(.install-method p) {
-  margin: 12px 0;
-  font-size: 14px;
-  line-height: 22px;
-}
-
 .installation-methods :deep(.installation-shortcuts + h2) {
   margin-top: 24px;
   padding-top: 0;
   border-top: 0;
 }
 
-.installation-methods :deep(.install-method > :last-child) {
-  margin-bottom: 0;
-}
-
-.installation-methods :deep(.install-method 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. */
-.installation-methods
-  :deep(.install-method div[class*='language-'] > span.lang) {
-  display: none;
-}
-
-.installation-methods :deep(.install-method div[class*='language-'] pre) {
-  padding: 14px 0;
-}
-
 :global(.installation-page div[class*='language-'] pre) {
   overflow-x: auto;
   overflow-y: hidden;
@@ -438,34 +271,6 @@ onUnmounted(() => {
   background: var(--vp-c-text-3);
 }
 
-.installation-methods :deep(.install-method 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. */
-.installation-methods
-  :deep(.install-method div[class*='language-'] > button.copy) {
-  top: 5px;
-  right: 6px;
-}
-
-.installation-methods :deep(.install-method .vp-code-group) {
-  margin-top: 16px;
-}
-
-.installation-methods :deep(.install-method .vp-code-group .tabs) {
-  margin: 0;
-  border-radius: 8px 8px 0 0;
-}
-
-.installation-methods
-  :deep(.install-method .vp-code-group div[class*='language-']) {
-  margin: 0;
-  border-radius: 0 0 8px 8px;
-}
-
 .installation-methods :deep(.install-hosting) {
   margin: 24px 0 40px;
   color: var(--vp-c-text-2);
@@ -492,10 +297,6 @@ onUnmounted(() => {
     padding: 8px 10px;
     font-size: 13px;
   }
-
-  .installation-methods :deep(.install-method) {
-    padding: 16px;
-  }
 }
 
 @media (max-width: 379px) {
@@ -520,10 +321,5 @@ onUnmounted(() => {
   .install-picker {
     display: none;
   }
-
-  .installation-methods :deep(.install-method) {
-    display: block !important;
-    break-inside: avoid;
-  }
 }
 </style>
diff --git a/website/src/next/docs/installation.md b/website/src/next/docs/installation.md
index 562b78f9bf..5a88702a84 100644
--- a/website/src/next/docs/installation.md
+++ b/website/src/next/docs/installation.md
@@ -6,6 +6,7 @@ pageClass: installation-page
 ---
 
 <script setup>
+import InstallationMethod from '../../../.vitepress/components/InstallationMethod.vue';
 import InstallationMethods from '../../../.vitepress/components/InstallationMethods.vue';
 </script>
 
@@ -25,23 +26,21 @@ Choose a package manager for your system, or install Task from a binary.
 
 Maintained by the Task team and kept up-to-date.
 
-<div class="install-method" data-platforms="macos">
+<InstallationMethod platforms="macos" platform-label="macOS">
 
-### [Homebrew](https://brew.sh) {#homebrew}
+<template #heading>
 
-<div class="install-meta">
+### [Homebrew](https://brew.sh) {#homebrew}
 
-<p class="install-platforms">macOS</p>
+</template>
 
-<div class="install-links">
+<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)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 brew install go-task/tap/go-task
@@ -53,23 +52,21 @@ Or use the Homebrew core formula:
 brew install go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Fedora · CentOS · Red Hat">
 
-### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
+<template #heading>
 
-<div class="install-meta">
+### [dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf) {#dnf}
 
-<p class="install-platforms">Fedora · CentOS · Red Hat</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Arpm)
 
-</div>
-
-</div>
+</template>
 
 Set up the repository:
 
@@ -83,23 +80,21 @@ Install Task:
 dnf install task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Ubuntu · Debian · Linux Mint">
 
-### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
+<template #heading>
 
-<div class="install-meta">
+### [apt](https://doc.ubuntu-fr.org/apt) {#apt}
 
-<p class="install-platforms">Ubuntu · Debian · Linux Mint</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Adeb)
 
-</div>
-
-</div>
+</template>
 
 Set up the repository:
 
@@ -113,23 +108,21 @@ Install Task:
 apt install task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Alpine Linux">
 
-### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
+<template #heading>
 
-<div class="install-meta">
+### [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) {#apk}
 
-<p class="install-platforms">Alpine Linux</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://cloudsmith.io/~task/repos/task/packages/?sort=-format&q=format%3Aalpine)
 
-</div>
-
-</div>
+</template>
 
 Set up the repository:
 
@@ -143,23 +136,21 @@ Install Task:
 apk add task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Linux">
 
-### [Snap](https://snapcraft.io/task) {#snap}
+<template #heading>
 
-<div class="install-meta">
+### [Snap](https://snapcraft.io/task) {#snap}
 
-<p class="install-platforms">Linux</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [Source](https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 sudo snap install task --classic
@@ -167,24 +158,22 @@ sudo snap install task --classic
 
 Requires a Linux distribution with classic confinement support.
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="macos linux windows">
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
 
-### [npm](https://www.npmjs.com) {#npm}
+<template #heading>
 
-<div class="install-meta">
+### [npm](https://www.npmjs.com) {#npm}
 
-<p class="install-platforms">macOS · Linux · Windows</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://www.npmjs.com/package/@go-task/cli)
 [Source](https://github.com/go-task/task/blob/main/package.json)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 npm install -g @go-task/cli
@@ -192,23 +181,21 @@ npm install -g @go-task/cli
 
 Task is also available as a project dependency.
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="windows">
+<InstallationMethod platforms="windows" platform-label="Windows">
 
-### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
+<template #heading>
 
-<div class="install-meta">
+### [WinGet](https://github.com/microsoft/winget-cli) {#winget}
 
-<p class="install-platforms">Windows</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [Source](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/Task/Task)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 winget install Task.Task
@@ -217,7 +204,7 @@ winget install Task.Task
 Available through the
 [WinGet community repository](https://github.com/microsoft/winget-pkgs).
 
-</div>
+</InstallationMethod>
 
 <p class="install-hosting">Package repository hosting for deb/rpm/apk is graciously provided by <a href="https://cloudsmith.com">Cloudsmith</a>.</p>
 
@@ -226,21 +213,19 @@ Available through the
 Maintained by the community, outside the Task team's control. These packages may
 lag behind the latest release.
 
-<div class="install-method" data-platforms="macos linux windows">
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
 
-### [Mise](https://mise.jdx.dev/) {#mise}
+<template #heading>
 
-<div class="install-meta">
+### [Mise](https://mise.jdx.dev/) {#mise}
 
-<p class="install-platforms">macOS · Linux · Windows</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://mise-tools.jdx.dev/tools/task)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 mise use -g task
@@ -249,229 +234,209 @@ mise use -g task
 For a project-local installation, use `mise use task` instead. This adds Task to
 your project's `mise.toml`.
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="macos">
+<InstallationMethod platforms="macos" platform-label="macOS">
 
-### [Macports](https://macports.org) {#macports}
+<template #heading>
 
-<div class="install-meta">
+### [Macports](https://macports.org) {#macports}
 
-<p class="install-platforms">macOS</p>
+</template>
 
-<div class="install-links">
+<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)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 port install go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="macos linux windows">
+<InstallationMethod platforms="macos linux windows" platform-label="macOS · Linux · Windows">
 
-### [pip](https://pip.pypa.io) {#pip}
+<template #heading>
 
-<div class="install-meta">
+### [pip](https://pip.pypa.io) {#pip}
 
-<p class="install-platforms">macOS · Linux · Windows</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://pypi.org/project/go-task-bin)
 [Source](https://github.com/Bing-su/pip-binary-factory/tree/main/task)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 pip install go-task-bin
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="windows">
+<InstallationMethod platforms="windows" platform-label="Windows">
 
-### [Chocolatey](https://chocolatey.org) {#chocolatey}
+<template #heading>
 
-<div class="install-meta">
+### [Chocolatey](https://chocolatey.org) {#chocolatey}
 
-<p class="install-platforms">Windows</p>
+</template>
 
-<div class="install-links">
+<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)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 choco install go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="windows">
+<InstallationMethod platforms="windows" platform-label="Windows">
 
-### [Scoop](https://scoop.sh) {#scoop}
+<template #heading>
 
-<div class="install-meta">
+### [Scoop](https://scoop.sh) {#scoop}
 
-<p class="install-platforms">Windows</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [Source](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 scoop install task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Arch Linux">
 
-### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
+<template #heading>
 
-<div class="install-meta">
+### Arch ([pacman](https://wiki.archlinux.org/title/Pacman)) {#arch}
 
-<p class="install-platforms">Arch Linux</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://archlinux.org/packages/extra/x86_64/go-task/)
 [Source](https://gitlab.archlinux.org/archlinux/packaging/packages/go-task)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 pacman -S go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Fedora">
 
-### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
+<template #heading>
 
-<div class="install-meta">
+### Fedora ([dnf](https://docs.fedoraproject.org/en-US/quick-docs/dnf)) {#fedora-community}
 
-<p class="install-platforms">Fedora</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
 [Source](https://src.fedoraproject.org/rpms/golang-github-task)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 dnf install go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="freebsd">
+<InstallationMethod platforms="freebsd" platform-label="FreeBSD">
 
-### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
+<template #heading>
 
-<div class="install-meta">
+### FreeBSD ([Ports](https://ports.freebsd.org/cgi/ports.cgi)) {#freebsd}
 
-<p class="install-platforms">FreeBSD</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://cgit.freebsd.org/ports/tree/devel/task)
 [Source](https://cgit.freebsd.org/ports/tree/devel/task/Makefile)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 pkg install task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux macos">
+<InstallationMethod platforms="linux macos" platform-label="Nix · NixOS · Linux · macOS">
 
-### [Nix](https://nixos.org) {#nix}
+<template #heading>
 
-<div class="install-meta">
+### [Nix](https://nixos.org) {#nix}
 
-<p class="install-platforms">Nix · NixOS · Linux · macOS</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [Source](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/go/go-task/package.nix)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 nix-env -iA nixpkgs.go-task
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="linux">
+<InstallationMethod platforms="linux" platform-label="Debian · Ubuntu">
 
-### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
+<template #heading>
 
-<div class="install-meta">
+### [pacstall](https://github.com/pacstall/pacstall) {#pacstall}
 
-<p class="install-platforms">Debian · Ubuntu</p>
+</template>
 
-<div class="install-links">
+<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)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 pacstall -I go-task-deb
 ```
 
-</div>
+</InstallationMethod>
 
-<div class="install-method" data-platforms="macos linux">
+<InstallationMethod platforms="macos linux" platform-label="macOS · Linux">
 
-### [pkgx](https://pkgx.sh) {#pkgx}
+<template #heading>
 
-<div class="install-meta">
+### [pkgx](https://pkgx.sh) {#pkgx}
 
-<p class="install-platforms">macOS · Linux</p>
+</template>
 
-<div class="install-links">
+<template #links>
 
 [View package](https://pkgx.dev/pkgs/taskfile.dev)
 [Source](https://github.com/pkgxdev/pantry/blob/main/projects/taskfile.dev/package.yml)
 
-</div>
-
-</div>
+</template>
 
 ```shell
 pkgx task
@@ -483,7 +448,7 @@ or, if you have pkgx integration enabled:
 task
 ```
 
-</div>
+</InstallationMethod>
 
 </InstallationMethods>