feat: add windows preview installer

3 files changed, 27 insertions, 4 deletions

diff --git a/docs/next/website/src/content/docs/index.mdx b/docs/next/website/src/content/docs/index.mdx
index f21ec902..27d41cb8 100644
--- a/docs/next/website/src/content/docs/index.mdx
+++ b/docs/next/website/src/content/docs/index.mdx
@@ -23,11 +23,18 @@ curl -fsSL https://herdr.dev/install.sh | sh
 herdr
 ```
 
+On Windows beta:
+
+```powershell
+$env:HERDR_CHANNEL="preview"; powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
+herdr
+```
+
 ## Start here
 
 <CardGrid>
   <Card title="Install">
-    Install Herdr on Linux or macOS, update it later, and verify the binary.
+    Install Herdr on Linux, macOS, or Windows beta, update it later, and verify the binary.
 
     [Install Herdr →](/docs/install/)
   </Card>
diff --git a/docs/next/website/src/content/docs/install.mdx b/docs/next/website/src/content/docs/install.mdx
index 41139821..e9ef8a53 100644
--- a/docs/next/website/src/content/docs/install.mdx
+++ b/docs/next/website/src/content/docs/install.mdx
@@ -7,13 +7,19 @@ Herdr ships as a single binary for Linux and macOS. Native Windows support is be
 
 ## Install
 
-Run the installer:
+On Linux or macOS, run:
 
 ```bash
 curl -fsSL https://herdr.dev/install.sh | sh
 ```
 
-The installer downloads the right release binary for your platform and places it on your PATH.
+On Windows beta, install the preview channel:
+
+```powershell
+$env:HERDR_CHANNEL="preview"; powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
+```
+
+The installer downloads the right release binary for your platform and places it on your PATH. The Windows installer uses versioned install folders and updates a `current` junction, so updates do not need to overwrite a running `herdr.exe`.
 
 ## Install with Homebrew
 
@@ -122,7 +128,7 @@ Choose the asset that matches your system:
 | macOS Apple silicon | `herdr-macos-aarch64` |
 | Windows x86_64 beta | `herdr-windows-x86_64.exe` |
 
-Make it executable and move it somewhere on your PATH.
+On Linux or macOS, make it executable and move it somewhere on your PATH.
 
 ```bash
 chmod +x herdr-linux-x86_64
diff --git a/docs/next/website/src/content/docs/windows-beta.mdx b/docs/next/website/src/content/docs/windows-beta.mdx
index 1d6e929f..f1663255 100644
--- a/docs/next/website/src/content/docs/windows-beta.mdx
+++ b/docs/next/website/src/content/docs/windows-beta.mdx
@@ -5,6 +5,16 @@ description: Native Windows support status, supported workflows, and known limit
 
 Native Windows support is beta. It runs as the same Herdr version as Linux and macOS, but some Unix features are intentionally unavailable on Windows.
 
+Install native Windows beta builds with PowerShell:
+
+```powershell
+$env:HERDR_CHANNEL="preview"; powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
+```
+
+Windows beta builds ship through the preview channel first. The Windows installer stores releases under `%USERPROFILE%\.herdr\packages\standalone\releases`, points `%LOCALAPPDATA%\Programs\Herdr\bin` at the current release, and keeps a small number of older releases so running processes do not block updates.
+
+For internal beta testing, `HERDR_MANIFEST_URL` can point the installer at a custom manifest instead of Herdr's stable or preview manifest.
+
 ## Supported in beta
 
 | Capability | Status |