From a04103f3a54e2ab184024718aa699c137770a79a Mon Sep 17 00:00:00 2001
From: Zach Vorhies <zachvorhies@protonmail.com>
Date: Wed, 21 Oct 2026 16:01:14 -0700
Subject: [PATCH] chore: prepare HTTP redirects for documentation cutover

---
 .vercelignore |  5 +++++
 README.md     | 33 +++++++++++++++++++++++++++++++++
 vercel.json   | 14 ++++++++++++++
 3 files changed, 52 insertions(+)
 create mode 100644 .vercelignore
 create mode 100644 vercel.json

diff --git a/.vercelignore b/.vercelignore
new file mode 100644
index 0000000..1881065
--- /dev/null
+++ b/.vercelignore
@@ -0,0 +1,5 @@
+.git
+.github
+README.md
+CNAME
+.nojekyll
diff --git a/README.md b/README.md
index 1723fc5..ab7e590 100644
--- a/README.md
+++ b/README.md
@@ -22,3 +22,36 @@ newer script fixes in this repository. Generated documentation and its history
 were excluded. The Pages custom domain is `fastled.io`; DNS remains on GitHub
 Pages. Migration history is tracked in
 [FastLED/FastLED#4878](https://github.com/FastLED/FastLED/issues/4878).
+
+## HTTP redirect cutover (pending hosting and DNS access)
+
+`vercel.json` prepares this static site for Vercel. Its `/docs/:path*` rule
+returns HTTP 308 to `https://fastled.github.io/dox/:path*`; Vercel forwards the
+query string. URL fragments remain client-side. There is no build step and
+existing `.html` URLs remain enabled. GitHub Pages continues serving production
+until the DNS cutover is verified; its browser redirect remains a fallback.
+
+1. Import `FastLED/fastled-fastled.github.io` into the FastLED Vercel team. Use
+   production branch `gh-pages`, root directory `.`, and framework **Other**.
+   First deploy the branch containing this configuration as a public preview.
+2. Check the preview with `curl -sSI` for `/docs`, `/docs/`,
+   `/docs/index.html`, and `/docs/d0/d00/example.html?search=FastLED`.
+   Each must return 308 and the corresponding `/dox/` destination, preserving
+   the query string. Verify the homepage, `/tools/paletteknife/`, its JavaScript,
+   a blog page, images, and CSS still return their expected content. Check a
+   missing non-docs path still returns 404.
+3. Add `fastled.io` and `www.fastled.io` to the Vercel project, with `www`
+   redirecting to the apex. In Gandi, use the exact DNS records and any ownership
+   verification records Vercel supplies for this project. Record the existing
+   GitHub Pages DNS values first for rollback. Keep unrelated DNS records.
+4. After DNS propagation and TLS provisioning, repeat the preview checks against
+   `https://fastled.io`, including the redirect status and `Location` header.
+   Only then is the HTTP redirect migration complete. Remove the old Pages
+   custom-domain binding after the successful cutover. The GitHub Pages preview
+   may remain available for rollback.
+5. If validation fails, restore the recorded GitHub Pages DNS records and retain
+   its custom-domain binding until the incident is resolved.
+
+References: [Vercel redirect behavior](https://vercel.com/docs/routing/redirects),
+[project configuration](https://vercel.com/docs/project-configuration/vercel-json),
+and [adding domains](https://vercel.com/docs/domains/working-with-domains/add-a-domain).
diff --git a/vercel.json b/vercel.json
new file mode 100644
index 0000000..3083027
--- /dev/null
+++ b/vercel.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": null,
+  "buildCommand": "",
+  "outputDirectory": ".",
+  "cleanUrls": false,
+  "redirects": [
+    {
+      "source": "/docs/:path*",
+      "destination": "https://fastled.github.io/dox/:path*",
+      "permanent": true
+    }
+  ]
+}