From 12812454c8eef4bc0b6ca6b85b49f0deb8c9b497 Mon Sep 17 00:00:00 2001
From: tannevaled <tannevaled@users.noreply.github.com>
Date: Thu, 8 Oct 2026 09:33:59 +0200
Subject: [PATCH] Landing kit from go-fileshare: neutral backgrounds, brand
 read from the logo

The stylesheet is now go-fileshare's, byte for byte (logos/landing-kit). The
only thing this site sets is [params.brand], derived from the logo's gradient:
base = its dark stop #047857 (5.48:1 on white, AA; the old #059669 was 3.77:1),
bright = its light stop #34d399. The [params.brand.surfaces] tables that
tinted the page background emerald (#f0fdf9 light, #04130d dark, where
go-fileshare renders #ffffff and #0b0e14) are gone, with the sheet code that
read them.

Checked with the kit's verify against go-fileshare.github.io: the built
<style> block equals the reference's once brand values are masked, and the
page background matches the reference pixel for pixel in light and dark
(headless Chrome, theme forced explicitly).

Also, as on go-fft: go-fileshare's skeleton (GitHub mark on the buttons, nav
Why / Example / API / Repositories, a full-width terminal with the verbatim
output of the hero's example run against ndarray v0.7.0, #api cards from
[[params.families]], ci.yml and links.yml), and riscv64 added to the SIMD
lists (RVV since v0.7.0, per the README).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .github/workflows/ci.yml                |  29 +++++++
 .github/workflows/links.yml             |  56 +++++++++++++
 hugo.toml                               |  99 ++++++++++-------------
 layouts/index.html                      |  51 +++++++++---
 layouts/partials/icons/OCTICONS-LICENSE |  21 +++++
 layouts/partials/icons/github.html      |   5 ++
 layouts/partials/styles.html            | 103 +++++++++++-------------
 7 files changed, 242 insertions(+), 122 deletions(-)
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 .github/workflows/links.yml
 create mode 100644 layouts/partials/icons/OCTICONS-LICENSE
 create mode 100644 layouts/partials/icons/github.html

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..ce98bc5
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,29 @@
+name: ci
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: the site builds
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: "0.167.0"
+          extended: true
+      - run: hugo --minify
+      # A page that builds and says nothing is a page nobody notices is empty.
+      - name: every repository is on it
+        run: |
+          for repo in ndarray docs brand; do
+            grep -q "go-ndarray/$repo" public/index.html \
+              || { echo "::error::$repo is not on the page"; exit 1; }
+          done
+          echo "the page names every repository this org has"
diff --git a/.github/workflows/links.yml b/.github/workflows/links.yml
new file mode 100644
index 0000000..6eb811d
--- /dev/null
+++ b/.github/workflows/links.yml
@@ -0,0 +1,56 @@
+name: links
+
+# Taken from go-fileshare.github.io, where a dead repository link on the
+# landing went unnoticed until a check like this one read the BUILT site.
+#
+# ⛔ THE CHECK READS THE BUILT SITE, NOT THE LAYOUTS: templated links such as
+# the per-repository cards only become real URLs once Hugo has expanded them.
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  links:
+    name: every link and image resolves
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          submodules: recursive
+      - uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: "0.167.0"
+          extended: true
+      - run: hugo --minify --destination ./public
+      - name: Check
+        run: |
+          set -uo pipefail
+          # The character class matters: an extractor that stops only at ) and "
+          # carries a closing > or < into the request.
+          urls=$(grep -rhoE 'https?://[^)">< [:space:]]+' public/ | sed 's/[.,]$//' | sort -u)
+          test -n "$urls" || { echo "::error::no links found; did the site build?"; exit 1; }
+          echo "checking $(printf '%s\n' "$urls" | wc -l) distinct URLs"
+          fail=0
+          while read -r u; do
+            # img.shields.io renders anything asked of it and proves nothing.
+            case "$u" in *img.shields.io*) continue ;; esac
+            # Three attempts: one is a flake detector rather than a link
+            # checker, and a lane that fails at random is a lane people learn
+            # to ignore.
+            code=000
+            for attempt in 1 2 3; do
+              code=$(curl -sS -o /dev/null -w '%{http_code}' -L --max-time 25 "$u" || echo 000)
+              case "$code" in 2*|3*) break ;; esac
+              sleep 3
+            done
+            case "$code" in
+              2*|3*) printf '  ok   %s  %s\n' "$code" "$u" ;;
+              *)     printf '  FAIL %s  %s\n' "$code" "$u"; fail=1 ;;
+            esac
+          done <<< "$urls"
+          test "$fail" -eq 0 || { echo "::error::at least one link or image does not resolve"; exit 1; }
diff --git a/hugo.toml b/hugo.toml
index 1eb6352..d1d9040 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -14,62 +14,6 @@ disableKinds = ['taxonomy', 'term', 'rss', 'sitemap', '404']
 [params]
   description = "go-ndarray is a pure-Go (CGO=0) NumPy-style n-dimensional array library for float64 — slicing/views, broadcasting, ufuncs, reductions and linear algebra, multicore + SIMD on amd64, arm64, ppc64le, loong64 and riscv64, with a Workspace arena for loops."
 
-# The colours are read by partials/styles.html. Emerald, shared with go-fft:
-# the two are one scientific-computing family, told apart by their glyphs.
-# The values are go-fft's, unchanged.
-[params.brand]
-  base   = "#059669"   # emerald-600: accent, primary button, gradient start
-  deep   = "#047857"   # emerald-700: gradient end
-  bright = "#34d399"   # emerald-400: accent in dark mode
-  shadow = "rgba(5,150,105,.7)"
-  chipBg     = "#d1fae5"
-  chipBorder = "#a7f3d0"
-  chipFg     = "#047857"
-  chipBgDark     = "rgba(52,211,153,.14)"
-  chipBorderDark = "rgba(52,211,153,.32)"
-  chipFgDark     = "#6ee7b7"
-  glow        = "rgba(110,231,183,.22)"
-  glow2       = "rgba(5,150,105,.10)"
-  glyphShadow = "rgba(5,150,105,.6)"
-  statsTint   = "#a7f3d0"
-  bandFg      = "#d1fae5"
-  # White on emerald-600 is 3.77:1, under the 4.5:1 body text needs; the band
-  # paragraph and the primary button sit on this gradient, so it runs one step
-  # darker than the accent: 700 -> 800 (white 5.48:1, #d1fae5 4.84:1 at worst).
-  gradFrom    = "#047857"
-  gradTo      = "#065f46"
-  # The hero's accent words: emerald-400 -> 300 on the dark background (the
-  # light theme keeps base -> deep, 600 -> 700).
-  gradTextDark = "linear-gradient(135deg,#34d399,#6ee7b7)"
-  [params.brand.surfaces]
-    ink        = "#052e22"
-    slate      = "#065f46"
-    muted2     = "#047857"
-    line       = "#a7f3d0"
-    bg         = "#f0fdf9"
-    bgSoft     = "#d1fae5"
-    surface    = "#ffffff"
-    navBg      = "rgba(240,253,249,.82)"
-    navBorder  = "#a7f3d0"
-    elevBorder = "#6ee7b7"
-    ghostHover = "#6ee7b7"
-    statsBg    = "#052e22"
-  [params.brand.surfacesDark]
-    ink        = "#d1fae5"
-    slate      = "#a7f3d0"
-    muted2     = "#6ee7b7"
-    line       = "#0a3d2a"
-    bg         = "#04130d"
-    bgSoft     = "#052e22"
-    surface    = "#06291c"
-    navBg      = "rgba(4,19,13,.82)"
-    navBorder  = "#0a3d2a"
-    elevBorder = "#10593d"
-    ghostHover = "#10593d"
-    statsBg    = "#06291c"
-
-# Each repo. Every field is rendered: "name" in the strip under the hero and on
-# its card, "kind" as the card's tag, "href" as both links, "blurb" in full.
 [[params.repos]]
   name  = "ndarray"
   kind  = "library · v0.7.0"
@@ -85,3 +29,46 @@ disableKinds = ['taxonomy', 'term', 'rss', 'sitemap', '404']
   kind  = "assets"
   href  = "https://github.com/go-ndarray/brand"
   blurb = "Logos and icons for the organization, in SVG / PNG / JPG / ICO / ICNS across colour, white and black variants."
+
+[params.brand]
+# Generated by logos/landing-kit/kit.py from static/img/logo.svg: the colours are
+# READ from the logo's gradient, never chosen. Do not add other keys:
+# neutrals (backgrounds, surfaces, greys) belong to the shared sheet.
+# Contrast: base on white 5.48:1, bright on the dark background 10.05:1.
+  base = "#047857"
+  deep = "#024935"
+  bright = "#34d399"
+  shadow = "rgba(4,120,87,.7)"
+  glow = "rgba(4,120,87,.6)"
+  wash = "rgba(4,120,87,.10)"
+  washDeep = "rgba(2,73,53,.06)"
+  chipBg = "#e7faf3"
+  chipBorder = "#c2f2e0"
+  chipFg = "#024935"
+  chipBgDark = "rgba(52,211,153,.14)"
+  chipBorderDark = "rgba(52,211,153,.32)"
+  chipFgDark = "#8fe7c7"
+
+# The API cards (#api) and the count in the hero come from this list, never
+# from a number typed beside it.
+[[params.families]]
+  name = "Creation"
+  what = "`Zeros`, `Ones`, `Full`, `Arange`, `Linspace`, `FromData`, `Eye` and the rest of NumPy's constructors, float64 throughout."
+[[params.families]]
+  name = "Views and indexing"
+  what = "`Reshape`, `Transpose` and NumPy basic indexing with `Slice(All(), A(0), …)`: strided views that share data, no copy."
+[[params.families]]
+  name = "Broadcasting and ufuncs"
+  what = "Elementwise arithmetic with NumPy broadcasting, and the unary functions, including `Exp` and `Log` ported from Arm's optimized-routines (≤ 0.51 ULP)."
+[[params.families]]
+  name = "Reductions"
+  what = "`Sum`, `Mean`, `Max`, `ArgMax`, `CumSum`, `Clip`, `Where`, whole-array or along an axis, multicore on large arrays."
+[[params.families]]
+  name = "Manipulation"
+  what = "`Concatenate`, `Stack` and the shape operations NumPy users reach for."
+[[params.families]]
+  name = "Linear algebra"
+  what = "`MatMul` and `Dot` through a panel-packed, cache-blocked GEMM with a go-asmgen SIMD micro-kernel per architecture."
+[[params.families]]
+  name = "Workspace"
+  what = "An arena for loops: `Use`, `Reset`, `Detach` — results stop costing the garbage collector from one pass to the next."
diff --git a/layouts/index.html b/layouts/index.html
index 2caa948..7809021 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -11,11 +11,9 @@
 <body class="lm">
   <header class="nav"><div class="wrap">
     <a class="brand" href="/"><img class="glyph" src="/img/logo.svg" width="32" height="32" alt="go-ndarray logo"> go-ndarray</a>
-    <nav><a href="#features">Why</a><a href="#repos">Repos</a><a href="#quality">Quality</a><a href="https://go-ndarray.github.io/docs/">Docs</a></nav>
+    <nav><a href="#features">Why</a><a href="#check">Example</a><a href="#api">API</a><a href="#repos">Repositories</a></nav>
     {{ partial "theme-toggle.html" . }}
-    {{- /* GitHub mark: Octicons "mark-github" (16px), @primer/octicons v19.38.0,
-           build/svg/mark-github-16.svg, MIT License (c) GitHub Inc. Path copied verbatim. */}}
-    <a class="btn btn-ghost" href="https://github.com/go-ndarray"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M6.766 11.328c-2.063-.25-3.516-1.734-3.516-3.656 0-.781.281-1.625.75-2.188-.203-.515-.172-1.609.063-2.062.625-.078 1.468.25 1.968.703.594-.187 1.219-.281 1.985-.281.765 0 1.39.094 1.953.265.484-.437 1.344-.765 1.969-.687.218.422.25 1.515.046 2.047.5.593.766 1.39.766 2.203 0 1.922-1.453 3.375-3.547 3.64.531.344.89 1.094.89 1.954v1.625c0 .468.391.734.86.547C13.781 14.359 16 11.53 16 8.03 16 3.61 12.406 0 7.984 0 3.563 0 0 3.61 0 8.031a7.88 7.88 0 0 0 5.172 7.422c.422.156.828-.125.828-.547v-1.25c-.219.094-.5.156-.75.156-1.031 0-1.64-.562-2.078-1.609-.172-.422-.36-.672-.719-.719-.187-.015-.25-.093-.25-.187 0-.188.313-.328.625-.328.453 0 .844.281 1.25.86.313.452.64.655 1.031.655s.641-.14 1-.5c.266-.265.47-.5.657-.656"/></svg>GitHub</a>
+    <a class="btn btn-ghost" href="https://github.com/go-ndarray">{{ partial "icons/github.html" . }}GitHub</a>
   </div></header>
 
   <div class="hero"><div class="wrap">
@@ -23,10 +21,10 @@
       <h1 class="head">NumPy-style n-dimensional arrays in pure Go.<br><span class="accent">float64, multicore + SIMD.</span></h1>
       <p class="sub"><b>go-ndarray</b> is the <code>numpy</code> equivalent for Go: a float64 n-dimensional array with creation routines, <b>strided views that share data</b>, broadcasting elementwise ops and ufuncs, reductions (incl. arg / cumulative / clip / where), manipulation, and linear algebra (a panel-packed, cache-blocked GEMM) — all in <b>pure Go, with cgo disabled</b>.</p>
       <div class="cta">
-        <a class="btn btn-primary" href="https://github.com/go-ndarray">Browse the repositories →</a>
-        <a class="btn btn-ghost" href="https://go-ndarray.github.io/docs/">Read the docs</a>
+        <a class="btn btn-primary" href="https://go-ndarray.github.io/docs/">Read the documentation →</a>
+        <a class="btn btn-ghost" href="https://github.com/go-ndarray/ndarray">{{ partial "icons/github.html" . }}Browse the source</a>
       </div>
-      <div class="trust"><span><b>{{ len .Site.Params.repos }}</b> repositories</span><span><b>CGO_ENABLED=0</b>, no BLAS shim</span><span><b>100%</b> test coverage</span></div>
+      <div class="trust"><span><b>{{ len .Site.Params.families }}</b> API families, NumPy's names</span><span><b>5</b> SIMD targets</span><span><b>CGO=0</b> no BLAS shim</span></div>
     </div>
     {{/* Lines taken verbatim from the Example section of go-ndarray/ndarray's README at v0.2.2. */}}
     <div class="term">
@@ -57,16 +55,37 @@ <h1 class="head">NumPy-style n-dimensional arrays in pure Go.<br><span class="ac
     <div class="mods">{{ range .Site.Params.repos }}<a href="{{ .href }}">{{ .name }}</a>{{ end }}</div>
   </div></div>
 
+  <section id="check" style="padding-top:10px"><div class="wrap">
+    <span class="eyebrow">Ask it, do not take our word</span>
+    <h2>The example above, <i>actually run</i>.</h2>
+    <p class="lead">The lines in the hero, built into a program against the published module and run. Views share data, broadcasting stretches <code>row</code> over both rows, and <code>MatMul</code> goes through the same cache-blocked SIMD kernel as a 4096² product. The output below is a real run, with nothing edited.</p>
+    <div class="term" style="margin-top:22px">
+      <div class="bar"><i style="background:#ff5f57"></i><i style="background:#febc2e"></i><i style="background:#28c840"></i><span class="t">go run ./ndcheck — zsh</span></div>
+{{/* Verbatim: go run of the hero's lines against
+     github.com/go-ndarray/ndarray v0.7.0, on an Apple M4 (arm64),
+     2026-10-08. Re-run it and paste its output when the API changes; never
+     retype a value here. */}}
+<pre style="white-space:pre;overflow-x:auto"><span class="c-com"># go-ndarray v0.7.0 — each step of the example, printed</span>
+<span class="c-cmd">$ go run</span> ./ndcheck
+<span class="c-out">m         Array(shape=[2 3], data=[0 1 2 3 4 5])
+m + row   Array(shape=[2 3], data=[10 21 32 13 24 35])
+m.T       Array(shape=[3 2], data=[0 3 1 4 2 5])
+sum(m,0)  Array(shape=[3], data=[3 5 7])
+m[:,0]    Array(shape=[2], data=[0 3])
+m @ b     Array(shape=[2 2], data=[10 13 28 40])</span></pre>
+    </div>
+  </div></section>
+
   <section id="features"><div class="wrap">
     <span class="eyebrow">Why go-ndarray</span>
     <h2>The n-dimensional array, <i>without</i> cgo.</h2>
-    <p class="lead">NumPy is the lingua franca of numerical computing, but in Go the choices are <code>gonum</code> (matrix-centric, amd64-only assembly) or a C extension. go-ndarray brings the <b>n-dimensional array</b> vocabulary — shapes, strided views, broadcasting, ufuncs, reductions and linear algebra — to Go with <b>no cgo</b>, cross-compiling to a static binary everywhere. The hot paths are multicore, and SIMD on amd64, arm64, ppc64le and loong64.</p>
+    <p class="lead">NumPy is the lingua franca of numerical computing, but in Go the choices are <code>gonum</code> (matrix-centric, amd64-only assembly) or a C extension. go-ndarray brings the <b>n-dimensional array</b> vocabulary — shapes, strided views, broadcasting, ufuncs, reductions and linear algebra — to Go with <b>no cgo</b>, cross-compiling to a static binary everywhere. The hot paths are multicore, and SIMD on amd64, arm64, ppc64le, loong64 and riscv64.</p>
     <div class="grid" id="quality">
       <div class="card"><div class="ico">🐹</div><h3>Pure Go</h3><p><code>CGO_ENABLED=0</code> across the org. No cgo, no BLAS shim.</p></div>
       <div class="card"><div class="ico">✅</div><h3>100% test coverage</h3><p>Gated in CI, differentially checked against <code>numpy</code>.</p></div>
       <div class="card"><div class="ico">🔢</div><h3>NumPy semantics</h3><p>Row-major strided arrays, <b>NumPy broadcasting</b>, and NumPy basic-indexing <code>Slice</code> returning strided views that share data.</p></div>
       <div class="card"><div class="ico">♻️</div><h3><code>Workspace</code> arena for loops</h3><p>Bind the inputs with <code>ws.Use</code>, compute as usual, <code>ws.Reset()</code> at the end of each pass: results stop costing the garbage collector anything. On a Zen 3, <code>x + y</code> on 1&nbsp;024 elements drops from 2.6 to 0.38&nbsp;µs (2.1× NumPy).</p></div>
-      <div class="card"><div class="ico">⚡</div><h3>SIMD on amd64, arm64, ppc64le &amp; loong64</h3><p>go-asmgen SIMD kernels on amd64 (SSE2, AVX2/FMA picked at run time), arm64 (NEON), ppc64le (VSX) and loong64 (LASX, when the CPU has it); riscv64, s390x and the 32-bit targets run the same pure-Go code those kernels are tested against.</p></div>
+      <div class="card"><div class="ico">⚡</div><h3>SIMD on amd64, arm64, ppc64le, loong64 &amp; riscv64</h3><p>go-asmgen SIMD kernels on amd64 (SSE2, AVX2/FMA picked at run time), arm64 (NEON), ppc64le (VSX) and loong64 (LASX, when the CPU has it) and riscv64 (RVV, when the CPU has it); riscv64, s390x and the 32-bit targets run the same pure-Go code those kernels are tested against.</p></div>
       <div class="card"><div class="ico">🎯</div><h3>Accurate <code>Exp</code>/<code>Log</code></h3><p>Ports of Arm's optimized-routines: worst 0.504 / 0.508 ULP against a 300-bit reference, and correct where Go's amd64 <code>math.Exp</code> returns +Inf (<a href="https://github.com/golang/go/issues/81995"><u>golang/go#81995</u></a>) and <code>math.Log</code> is wrong on subnormals (<a href="https://github.com/golang/go/issues/56600"><u>golang/go#56600</u></a>).</p></div>
       <div class="card"><div class="ico">🧪</div><h3>Multi-arch CI</h3><p>The suite runs on amd64, arm64 and 386 natively and on riscv64/loong64/ppc64le/s390x/arm under qemu, on Linux, macOS and Windows, and compiles for every <code>GOOS/GOARCH</code> pair Go supports; v0.2.0 was also run on real amd64, arm64, ppc64le, riscv64 and loong64 hardware.</p></div>
       <div class="card"><div class="ico">💎</div><h3>The cgo-free ndarray that was missing</h3><p>Ruby has no cgo-free ndarray (<code>Numo::NArray</code> and <code>NMatrix</code> are C extensions) and <code>gonum</code>'s optimized assembly is amd64-only. go-ndarray pairs a portable pure-Go core with multicore fan-out and SIMD kernels.</p></div>
@@ -74,6 +93,16 @@ <h2>The n-dimensional array, <i>without</i> cgo.</h2>
     </div>
   </div></section>
 
+  <section id="api" style="padding-top:10px"><div class="wrap">
+    <span class="eyebrow">What the module offers</span>
+    <h2>{{ len .Site.Params.families }} families, <i>NumPy's names</i>.</h2>
+    <div class="grid">
+      {{ range .Site.Params.families }}
+      <div class="card"><h3>{{ .name }}</h3><p>{{ .what | markdownify }}</p></div>
+      {{ end }}
+    </div>
+  </div></section>
+
   <section id="perf" style="padding-top:10px"><div class="wrap">
     <div class="stats">
       <div><div class="n">100%</div><div class="l">test coverage, differentially checked against numpy</div></div>
@@ -100,8 +129,8 @@ <h2>What is here.</h2>
   <section id="eco" style="padding-top:6px"><div class="wrap">
     <div class="band">
       <h2>The cgo-free ndarray the Go and Ruby ecosystems lacked.</h2>
-      <p>No cgo, no BLAS shim. A portable pure-Go core, multicore, with SIMD kernels on amd64, arm64, ppc64le and loong64 and a <code>Workspace</code> arena that takes the garbage collector out of loops. Faster than NumPy on whole-array and row reductions, on large <code>Exp</code> and on <code>MatMul</code> against single-threaded BLAS, slower against 16-thread BLAS — the numbers are on the <a href="https://go-ndarray.github.io/docs/latest/performance/"><u>performance page</u></a>.</p>
-      <a class="btn btn-ghost" href="https://github.com/go-ndarray/ndarray">Read the source on GitHub →</a>
+      <p>No cgo, no BLAS shim. A portable pure-Go core, multicore, with SIMD kernels on amd64, arm64, ppc64le, loong64 and riscv64 and a <code>Workspace</code> arena that takes the garbage collector out of loops. Faster than NumPy on whole-array and row reductions, on large <code>Exp</code> and on <code>MatMul</code> against single-threaded BLAS, slower against 16-thread BLAS — the numbers are on the <a href="https://go-ndarray.github.io/docs/latest/performance/"><u>performance page</u></a>.</p>
+      <a class="btn btn-ghost" href="https://github.com/go-ndarray/ndarray">{{ partial "icons/github.html" . }}Read the source on GitHub →</a>
     </div>
   </div></section>
 
diff --git a/layouts/partials/icons/OCTICONS-LICENSE b/layouts/partials/icons/OCTICONS-LICENSE
new file mode 100644
index 0000000..aa1fa80
--- /dev/null
+++ b/layouts/partials/icons/OCTICONS-LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GitHub Inc.
+
+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.
diff --git a/layouts/partials/icons/github.html b/layouts/partials/icons/github.html
new file mode 100644
index 0000000..118ad5b
--- /dev/null
+++ b/layouts/partials/icons/github.html
@@ -0,0 +1,5 @@
+{{- /* GitHub's mark: Octicons "mark-github" (16 px), primer/octicons @primer/octicons-react@19.40.0,
+     copied verbatim, MIT, (c) GitHub Inc.: the licence is OCTICONS-LICENSE
+     beside this file. currentColor, so it takes the button's text colour in
+     both themes; aria-hidden, since the button's text already names GitHub. */ -}}
+<svg class="icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M6.766 11.328c-2.063-.25-3.516-1.734-3.516-3.656 0-.781.281-1.625.75-2.188-.203-.515-.172-1.609.063-2.062.625-.078 1.468.25 1.968.703.594-.187 1.219-.281 1.985-.281.765 0 1.39.094 1.953.265.484-.437 1.344-.765 1.969-.687.218.422.25 1.515.046 2.047.5.593.766 1.39.766 2.203 0 1.922-1.453 3.375-3.547 3.64.531.344.89 1.094.89 1.954v1.625c0 .468.391.734.86.547C13.781 14.359 16 11.53 16 8.03 16 3.61 12.406 0 7.984 0 3.563 0 0 3.61 0 8.031a7.88 7.88 0 0 0 5.172 7.422c.422.156.828-.125.828-.547v-1.25c-.219.094-.5.156-.75.156-1.031 0-1.64-.562-2.078-1.609-.172-.422-.36-.672-.719-.719-.187-.015-.25-.093-.25-.187 0-.188.313-.328.625-.328.453 0 .844.281 1.25.86.313.452.64.655 1.031.655s.641-.14 1-.5c.266-.265.47-.5.657-.656"/></svg>
diff --git a/layouts/partials/styles.html b/layouts/partials/styles.html
index 519456b..d50c2a8 100644
--- a/layouts/partials/styles.html
+++ b/layouts/partials/styles.html
@@ -19,32 +19,22 @@
 {{ $deep   := $br.deep   | default "#054A66" }}
 {{ $bright := $br.bright | default "#22CCE2" }}
 {{ $shadow := $br.shadow | default "rgba(0,121,168,.7)" }}
+{{- /* Three more that were written into the RULES rather than taken as
+     parameters, so every org using this sheet glowed cyan whatever its logo
+     was. Measured on the published amber page: go-pkgx's rendered CSS carried
+     four cyan literals -- the nav glyph's drop shadow, both hero washes and
+     the performance hero's. Each default below is the exact text that was in
+     the rule, so a build with no [params.brand] still emits a byte-identical
+     <style> block and the check in the README keeps meaning something. */}}
+{{- $glow     := $br.glow     | default "rgba(0,121,168,.6)" }}
+{{- $wash     := $br.wash     | default "rgba(0,121,168,.10)" }}
+{{- $washDeep := $br.washDeep | default "rgba(5,74,102,.06)" }}
 {{ $chipBg     := $br.chipBg     | default "#e8f8fc" }}
 {{ $chipBorder := $br.chipBorder | default "#bde9f4" }}
 {{ $chipFg     := $br.chipFg     | default "#054A66" }}
 {{ $chipBgD     := $br.chipBgDark     | default "rgba(34,204,226,.14)" }}
 {{ $chipBorderD := $br.chipBorderDark | default "rgba(34,204,226,.32)" }}
 {{ $chipFgD     := $br.chipFgDark     | default "#7fe4f3" }}
-{{/* Added for go-fft: the tints that were still written in as cyan, and the
-     neutral surfaces, which go-fft keeps emerald-tinted. Every default is the
-     value go-authn renders today, so a copy with no such params is unchanged. */}}
-{{ $glow    := $br.glow    | default "rgba(0,121,168,.10)" }}
-{{ $glow2   := $br.glow2   | default "rgba(5,74,102,.06)" }}
-{{ $glyphShadow := $br.glyphShadow | default "rgba(0,121,168,.6)" }}
-{{ $statsTint := $br.statsTint | default "#cdf1fa" }}
-{{ $bandFg  := $br.bandFg  | default "#d8f3fb" }}
-{{/* The gradient behind white text (primary button, CTA band). It defaults to
-     base -> deep, as before; an org whose base is too light to carry white
-     text at 4.5:1 moves it one step darker without changing its accent. */}}
-{{ $gradFrom := $br.gradFrom | default $base }}
-{{ $gradTo   := $br.gradTo   | default $deep }}
-{{/* The gradient the hero's accent words are painted with. It stays base ->
-     deep in both themes unless gradTextDark is set: with the darker button
-     gradient above, the same words would vanish into a dark background. */}}
-{{ $gradText := printf "linear-gradient(135deg,%s,%s)" $base $deep }}
-{{ $gradTextD := $br.gradTextDark | default $gradText }}
-{{ $sf  := $br.surfaces | default dict }}
-{{ $sfD := $br.surfacesDark | default dict }}
 <script>
   /* Apply the saved theme before first paint to avoid a flash; "system" leaves no attribute. */
   (function(){var m=localStorage.getItem('theme');if(m&&m!=='system')document.documentElement.setAttribute('data-theme',m);})();
@@ -53,47 +43,46 @@
   :root{
     /* brand */
     --cyan:{{ $base | safeCSS }}; --cyan-deep:{{ $deep | safeCSS }};
-    --grad:linear-gradient(135deg,{{ $gradFrom | safeCSS }},{{ $gradTo | safeCSS }});
-    --grad-text:{{ $gradText | safeCSS }};
+    --grad:linear-gradient(135deg,{{ $base | safeCSS }},{{ $deep | safeCSS }});
     /* interactive / text accent (brightens in dark for contrast) */
     --accent:{{ $base | safeCSS }}; --accent-deep:{{ $deep | safeCSS }};
     /* text + surfaces (light) */
-    --ink:{{ $sf.ink | default "#0f1115" | safeCSS }}; --slate:{{ $sf.slate | default "#475569" | safeCSS }}; --muted-2:{{ $sf.muted2 | default "#8893a4" | safeCSS }};
-    --line:{{ $sf.line | default "#e7e9ee" | safeCSS }}; --bg:{{ $sf.bg | default "#ffffff" | safeCSS }}; --bg-soft:{{ $sf.bgSoft | default "#f7f8fb" | safeCSS }};
-    --surface:{{ $sf.surface | default "#ffffff" | safeCSS }}; --surface-2:{{ $sf.surface | default "#ffffff" | safeCSS }};
-    --nav-bg:{{ $sf.navBg | default "rgba(255,255,255,.82)" | safeCSS }}; --nav-border:{{ $sf.navBorder | default "#e7e9ee" | safeCSS }};
-    --elev-border:{{ $sf.elevBorder | default "#e0e3ea" | safeCSS }}; --ghost-border-hover:{{ $sf.ghostHover | default "#cfd4dd" | safeCSS }};
+    --ink:#0f1115; --slate:#475569; --muted-2:#8893a4;
+    --line:#e7e9ee; --bg:#ffffff; --bg-soft:#f7f8fb;
+    --surface:#ffffff; --surface-2:#ffffff;
+    --nav-bg:rgba(255,255,255,.82); --nav-border:#e7e9ee;
+    --elev-border:#e0e3ea; --ghost-border-hover:#cfd4dd;
     /* ruby chip (pill / icon / active tag) */
     --chip-bg:{{ $chipBg | safeCSS }}; --chip-border:{{ $chipBorder | safeCSS }}; --chip-fg:{{ $chipFg | safeCSS }};
     /* semantic */
     --ok-bg:#e7f6ec; --ok-fg:#1a7f37; --win-bg:#f3fbf5;
-    --stats-bg:{{ $sf.statsBg | default "#0f1115" | safeCSS }}; --na:#a8b0bd;
+    --stats-bg:#0f1115; --na:#a8b0bd;
     --radius:18px;
   }
   /* Dark theme — applied by the media query for un-forced "system", and by an explicit toggle. */
   @media(prefers-color-scheme:dark){
     :root:not([data-theme]){
-      --accent:{{ $bright | safeCSS }}; --accent-deep:{{ $bright | safeCSS }}; --grad-text:{{ $gradTextD | safeCSS }};
-      --ink:{{ $sfD.ink | default "#e6edf3" | safeCSS }}; --slate:{{ $sfD.slate | default "#9aa4b2" | safeCSS }}; --muted-2:{{ $sfD.muted2 | default "#7d8798" | safeCSS }};
-      --line:{{ $sfD.line | default "#232a36" | safeCSS }}; --bg:{{ $sfD.bg | default "#0b0e14" | safeCSS }}; --bg-soft:{{ $sfD.bgSoft | default "#111620" | safeCSS }};
-      --surface:{{ $sfD.surface | default "#141a24" | safeCSS }}; --surface-2:{{ $sfD.surface | default "#141a24" | safeCSS }};
-      --nav-bg:{{ $sfD.navBg | default "rgba(11,14,20,.82)" | safeCSS }}; --nav-border:{{ $sfD.navBorder | default "#1c2331" | safeCSS }};
-      --elev-border:{{ $sfD.elevBorder | default "#2a3342" | safeCSS }}; --ghost-border-hover:{{ $sfD.ghostHover | default "#3a4556" | safeCSS }};
+      --accent:{{ $bright | safeCSS }}; --accent-deep:{{ $bright | safeCSS }};
+      --ink:#e6edf3; --slate:#9aa4b2; --muted-2:#7d8798;
+      --line:#232a36; --bg:#0b0e14; --bg-soft:#111620;
+      --surface:#141a24; --surface-2:#141a24;
+      --nav-bg:rgba(11,14,20,.82); --nav-border:#1c2331;
+      --elev-border:#2a3342; --ghost-border-hover:#3a4556;
       --chip-bg:{{ $chipBgD | safeCSS }}; --chip-border:{{ $chipBorderD | safeCSS }}; --chip-fg:{{ $chipFgD | safeCSS }};
       --ok-bg:rgba(63,185,80,.16); --ok-fg:#56d364; --win-bg:rgba(63,185,80,.08);
-      --stats-bg:{{ $sfD.statsBg | default "#141a24" | safeCSS }}; --na:#5b6472;
+      --stats-bg:#141a24; --na:#5b6472;
     }
   }
   :root[data-theme="dark"]{
-    --accent:{{ $bright | safeCSS }}; --accent-deep:{{ $bright | safeCSS }}; --grad-text:{{ $gradTextD | safeCSS }};
-    --ink:{{ $sfD.ink | default "#e6edf3" | safeCSS }}; --slate:{{ $sfD.slate | default "#9aa4b2" | safeCSS }}; --muted-2:{{ $sfD.muted2 | default "#7d8798" | safeCSS }};
-    --line:{{ $sfD.line | default "#232a36" | safeCSS }}; --bg:{{ $sfD.bg | default "#0b0e14" | safeCSS }}; --bg-soft:{{ $sfD.bgSoft | default "#111620" | safeCSS }};
-    --surface:{{ $sfD.surface | default "#141a24" | safeCSS }}; --surface-2:{{ $sfD.surface | default "#141a24" | safeCSS }};
-    --nav-bg:{{ $sfD.navBg | default "rgba(11,14,20,.82)" | safeCSS }}; --nav-border:{{ $sfD.navBorder | default "#1c2331" | safeCSS }};
-    --elev-border:{{ $sfD.elevBorder | default "#2a3342" | safeCSS }}; --ghost-border-hover:{{ $sfD.ghostHover | default "#3a4556" | safeCSS }};
+    --accent:{{ $bright | safeCSS }}; --accent-deep:{{ $bright | safeCSS }};
+    --ink:#e6edf3; --slate:#9aa4b2; --muted-2:#7d8798;
+    --line:#232a36; --bg:#0b0e14; --bg-soft:#111620;
+    --surface:#141a24; --surface-2:#141a24;
+    --nav-bg:rgba(11,14,20,.82); --nav-border:#1c2331;
+    --elev-border:#2a3342; --ghost-border-hover:#3a4556;
     --chip-bg:{{ $chipBgD | safeCSS }}; --chip-border:{{ $chipBorderD | safeCSS }}; --chip-fg:{{ $chipFgD | safeCSS }};
     --ok-bg:rgba(63,185,80,.16); --ok-fg:#56d364; --win-bg:rgba(63,185,80,.08);
-    --stats-bg:{{ $sfD.statsBg | default "#141a24" | safeCSS }}; --na:#5b6472;
+    --stats-bg:#141a24; --na:#5b6472;
   }
   *{box-sizing:border-box}
   html,body{margin:0;padding:0}
@@ -107,7 +96,7 @@
   .nav .wrap{display:flex;align-items:center;gap:14px;height:64px}
   .brand{display:flex;align-items:center;gap:10px;font-weight:800;letter-spacing:-.02em}
   .glyph{width:32px;height:32px;border-radius:9px;display:block;
-    box-shadow:0 6px 16px -6px {{ $glyphShadow | safeCSS }}}
+    box-shadow:0 6px 16px -6px {{ $glow | safeCSS }}}
   .nav nav{margin-left:auto;display:flex;gap:26px;color:var(--slate);font-weight:600;font-size:14px}
   .nav nav a:hover{color:var(--ink)}
   .theme-toggle{display:inline-flex;align-items:center;gap:7px;font:inherit;font-weight:700;font-size:13px;cursor:pointer;
@@ -115,21 +104,25 @@
   .theme-toggle:hover{border-color:var(--ghost-border-hover)}
   .btn{display:inline-flex;align-items:center;gap:8px;font-weight:700;font-size:14px;padding:11px 18px;
     border-radius:12px;border:1px solid transparent;transition:.15s}
-  /* .lm prefix: ".lm a{color:inherit}" outranks a bare .btn-primary, which
-     painted the label in --ink -- near-black on the gradient in light mode. */
-  .lm .btn-primary{background:var(--grad);color:#fff;box-shadow:0 10px 24px -10px {{ $shadow | safeCSS }}}
+  {{/* ⛔ `.btn.btn-primary`, not `.btn-primary`. Further down this file sits
+       `.lm a{color:inherit}`, and `.lm a` is a class AND an element -- (0,1,1)
+       -- which BEATS a single class. So the primary button, which is an <a>,
+       took `inherit` and rendered the hero's near-black ink on its brand
+       gradient. `.band .btn-ghost` was right all along for the same reason read
+       the other way: two classes, (0,2,0), so it won and came out white. */}}
+  .btn.btn-primary{background:var(--grad);color:#fff;box-shadow:0 10px 24px -10px {{ $shadow | safeCSS }}}
   .btn-primary:hover{transform:translateY(-1px)}
-  .btn-ghost{border-color:var(--line);color:var(--ink);background:var(--surface-2)}
+  .btn.btn-ghost{border-color:var(--line);color:var(--ink);background:var(--surface-2)}
   .btn-ghost:hover{border-color:var(--ghost-border-hover)}
   /* hero */
   .hero{padding:74px 0 30px;background:
-    radial-gradient(900px 380px at 78% -8%,{{ $glow | safeCSS }},transparent 60%),
-    radial-gradient(700px 320px at 0% 0%,{{ $glow2 | safeCSS }},transparent 55%)}
+    radial-gradient(900px 380px at 78% -8%,{{ $wash | safeCSS }},transparent 60%),
+    radial-gradient(700px 320px at 0% 0%,{{ $washDeep | safeCSS }},transparent 55%)}
   .hero .wrap{display:grid;grid-template-columns:1.05fr .95fr;gap:48px;align-items:center}
   .pill{display:inline-flex;align-items:center;gap:8px;font-size:12.5px;font-weight:700;color:var(--chip-fg);
     background:var(--chip-bg);border:1px solid var(--chip-border);padding:6px 12px;border-radius:999px}
   h1.head{font-size:54px;line-height:1.04;letter-spacing:-.035em;font-weight:850;margin:0}
-  h1.head .accent{background:var(--grad-text);-webkit-background-clip:text;background-clip:text;color:transparent}
+  h1.head .accent{background:var(--grad);-webkit-background-clip:text;background-clip:text;color:transparent}
   .sub{font-size:18.5px;color:var(--slate);margin:18px 0 26px;max-width:540px}
   .cta{display:flex;gap:12px;flex-wrap:wrap}
   .trust{margin-top:22px;display:flex;gap:22px;flex-wrap:wrap;color:var(--slate);font-size:13px;font-weight:600}
@@ -165,7 +158,7 @@
   /* stats — intentionally a dark panel in both themes */
   .stats{background:var(--stats-bg);color:#fff;border-radius:26px;padding:42px;display:grid;grid-template-columns:repeat(4,1fr);gap:24px;text-align:center;
     box-shadow:0 40px 80px -40px rgba(15,17,21,.6)}
-  .stats .n{font-size:40px;font-weight:850;letter-spacing:-.03em;background:linear-gradient(135deg,#fff,{{ $statsTint | safeCSS }});-webkit-background-clip:text;background-clip:text;color:transparent}
+  .stats .n{font-size:40px;font-weight:850;letter-spacing:-.03em;background:linear-gradient(135deg,#fff,#cdf1fa);-webkit-background-clip:text;background-clip:text;color:transparent}
   .stats .l{color:#9aa3b2;font-size:13.5px;margin-top:4px}
   /* roadmap */
   .road{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin-top:36px}
@@ -180,7 +173,7 @@
   .band{background:var(--grad);border-radius:26px;padding:54px;color:#fff;text-align:center;position:relative;overflow:hidden}
   .band:after{content:"";position:absolute;inset:0;background:radial-gradient(600px 240px at 80% 120%,rgba(255,255,255,.18),transparent)}
   .band h2{color:#fff;font-size:32px}
-  .band p{color:{{ $bandFg | safeCSS }};margin:12px auto 26px;max-width:520px;position:relative;z-index:1}
+  .band p{color:#d8f3fb;margin:12px auto 26px;max-width:520px;position:relative;z-index:1}
   .band .btn-ghost{background:rgba(255,255,255,.12);border-color:rgba(255,255,255,.4);color:#fff;position:relative;z-index:1}
   footer{padding:40px 0;color:var(--muted-2);font-size:13.5px;border-top:1px solid var(--line)}
   footer .wrap{display:flex;flex-wrap:wrap;gap:14px;justify-content:space-between}
@@ -189,9 +182,9 @@
   /* performance page */
   .pwrap{max-width:1120px;margin:0 auto;padding:0 24px}
   .phero{padding:64px 0 18px;background:
-    radial-gradient(900px 360px at 80% -10%,{{ $glow | safeCSS }},transparent 60%)}
+    radial-gradient(900px 360px at 80% -10%,{{ $wash | safeCSS }},transparent 60%)}
   .phero h1{font-size:46px;line-height:1.05;letter-spacing:-.035em;font-weight:850;margin:10px 0 0}
-  .phero h1 .accent{background:var(--grad-text);-webkit-background-clip:text;background-clip:text;color:transparent}
+  .phero h1 .accent{background:var(--grad);-webkit-background-clip:text;background-clip:text;color:transparent}
   .phero .sub{font-size:18px;color:var(--slate);margin:16px 0 0;max-width:760px}
   .psec{padding:46px 0}
   .psec h2{font-size:28px;letter-spacing:-.03em;font-weight:820;margin:0}
@@ -211,7 +204,7 @@
   td.na{color:var(--na)}
   .pcards{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin-top:22px}
   .pcard{border:1px solid var(--line);border-radius:16px;padding:22px;background:var(--surface)}
-  .pcard .n{font-size:30px;font-weight:850;letter-spacing:-.03em;background:var(--grad-text);-webkit-background-clip:text;background-clip:text;color:transparent}
+  .pcard .n{font-size:30px;font-weight:850;letter-spacing:-.03em;background:var(--grad);-webkit-background-clip:text;background-clip:text;color:transparent}
   .pcard h3{margin:6px 0 6px;font-size:16px}
   .pcard p{margin:0;color:var(--slate);font-size:14px}
   .applist{margin-top:22px;display:grid;grid-template-columns:1fr 1fr;gap:16px}