feat(site): landing links, what's new, shared tokens, CI guardrails (#302)

* feat(gallery): detail-page navigation, code ergonomics, image polish

Detail pages were dead ends: a reader who finished one example had to go
back to the grid to find the next. They now page within their own kind
(prev/next, arrow keys), list their tags as links back to the filtered
index, and end with three related entries chosen by shared topic tags.

Source listings gain a line-number gutter and collapse past 120 lines;
every code block gets a copy button with a non-secure-context fallback
and a visible failure state; README headings get stable anchors.

Card images carry intrinsic dimensions so the grid no longer shifts as
they load, and the lightbox only closes on backdrop, button or Esc --
clicking the image toggles native size instead.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

* feat(gallery): browse controls and interaction feel

Showcase pieces were reachable only through a "showcase" topic chip, one
tag could be active at a time, and the grid had one fixed order. The
index now has an All / Examples / Showcase switch, AND-combined topic
chips, and a Gallery order / Name A-Z sort, all mirrored in the URL hash
(k=, tag=a,b, s=). Legacy #tag=showcase links, the landing page's among
them, resolve to the Showcase switch so no inbound link breaks.

Search no longer rewrites the hash on every keystroke, card renders fade
in once decoded, hover gets a restrained zoom that reduced-motion turns
off (replacing a rule that disabled a transform nobody set), focus rings
sit inside segmented controls instead of being clipped, README prose is
capped at a readable measure, and the sticky bar packs tighter on phones.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

* feat(site): landing links, what's new, shared tokens, CI guardrails

The landing page listed skills and rules as bare slugs a reader could not
open, carried six collapse carets that collapsed nothing, and hardcoded
the Blender versions in four places. Skills and rules now link to their
files, each skill shows its trigger list on demand, both panels get a
filter, versions come from site.json, and the HUD corners no longer stay
invisible when scripts are off.

A "What's new" panel shows the latest release and the six most recently
added examples and showcase pieces, dated by the commit that first added
each directory -- gallery JSON order is not add order. Deploy fetches
full history for it; a shallow clone hides the strip rather than lying.

scripts/site/tokens.css was a dead fleet leftover with a GitHub palette
nobody used, while the real palette was hand-copied into three pages.
It is now the single :root both builds inline.

Nothing checked the landing page before it deployed. A validate-site job
builds it and tests/check_site_links.py resolves every internal href,
src and #anchor across all 91 pages and requires alt on every <img>;
the deploy runs the same check, and installs the pinned requirements.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

---------

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: TMHSDigital

.github/workflows/pages.yml

@@ -68,12 +68,16 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
+        with:
+          # Full history: the landing page's "Recently added" dates come from
+          # the commit that first added each example (a shallow clone hides it).
+          fetch-depth: 0
 
       - uses: actions/setup-python@v7
         with:
           python-version: "3.12"
 
-      - run: pip install Jinja2
+      - run: pip install -r scripts/site/requirements.txt
 
       - name: Build landing page (vendored template)
         run: python scripts/site/build_site.py --repo-root . --out docs
@@ -83,6 +87,9 @@ jobs:
         # drift from gallery.json. The committed docs/gallery/assets/*.webp are untouched.
         run: python scripts/build_gallery.py
 
+      - name: Check every internal link, anchor and image alt
+        run: python tests/check_site_links.py
+
       - uses: actions/configure-pages@v6
 
       - uses: actions/upload-pages-artifact@v5

.github/workflows/validate.yml

@@ -186,6 +186,26 @@ jobs:
           echo "Templates: $template_count"
           echo "Snippets: $snippet_count"
 
+  validate-site:
+    name: Build landing page and check site links
+    # The landing page is built only at deploy (docs/index.html is untracked),
+    # so a template error or a dead link otherwise surfaces in production.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - run: pip install -r scripts/site/requirements.txt
+
+      - name: Build landing page into docs/
+        run: python scripts/site/build_site.py --repo-root . --out docs
+
+      - name: Check every internal link, anchor and image alt
+        run: python tests/check_site_links.py
+
   validate-manifest:
     name: Validate plugin manifest
     runs-on: ubuntu-latest

docs/gallery/anvil/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/apothecary-shelf/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/armature-bend/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/attribute-domain-shear/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/bake-normal-high-to-low/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/bmesh-gear/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/book-trolley/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }

docs/gallery/bookshelf/index.html

@@ -34,16 +34,22 @@
     @font-face { font-family: 'JetBrains Mono'; font-weight: 400; font-display: swap;
       src: url('../../fonts/jetbrains-mono-regular.woff2') format('woff2'); }
 
-    /* Blender-viewport system, shared with the landing page. Dark only. */
+    /* Palette and type: scripts/site/tokens.css, shared with the landing page. */
     :root {
       color-scheme: dark;
-      --bg: #1a1b1e; --surface: #222327; --surface-2: #2a2b30; --bg2: #131417;
-      --border: #3a3b40; --text: #e8e9eb; --text-dim: #9698a0;
+      --bg: #1a1b1e; --bg2: #131417; --panel: #222327; --panel-2: #2a2b30;
+      --border: #3a3b40; --text: #e8e9eb; --dim: #9698a0;
       --select: #ff8c19; --ok: #6dc96d;
-      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
+      --ax-x: #ff3352; --ax-y: #8bdc00; --ax-z: #2890ff;
       --font-display: 'Barlow Condensed', 'Arial Narrow', sans-serif;
-      --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
       --font-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+      /* gallery vocabulary for the same values */
+      --surface: var(--panel); --surface-2: var(--panel-2); --text-dim: var(--dim);
+      --font-sans: var(--font-body);
+    }
+    :root {
+      --radius: 4px; --radius-lg: 6px; --maxw: 1080px;
       --code-k: #ff7b72; --code-s: #a5d6ff; --code-c: #9698a0; --code-n: #79c0ff;
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }