jekyll-theme-zer0 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bb7f0d10a0dcb7cbe5297c6a412db670fc837d5acc43c85b6752baab5acf5a9
-  data.tar.gz: '0095e82963f7316a63fecdf355f6fb3e8a126c7528666ab540d274175dda515c'
+  metadata.gz: 73435219bd711a7e8485d895f8e07156804569313c0213be215495e994a72c6b
+  data.tar.gz: ff65b97cd663f7cacd18757aad849725c18c9e036563e72bff8185e894dd8c47
 SHA512:
-  metadata.gz: 0240ae6516cbc159ae33925ad991e74b958ddbbe19c3806fdf6cde01ba7e625ae6a530184cde8a3e51d5e7748944eba105fec439cde7332910bce2e027f2b5d7
-  data.tar.gz: 80283b4cb1950832efac7b7713f660bab1d106adcc0dbeb320c385570a95cc5fd8e6f88614fd09fabdbc44081369300bc6e4e88ade905125edf5caad4ac14c74
+  metadata.gz: 94a2e3468724372bbf8478f3615b3195a6182a0775dd4ab45be19d9b0a57cdb0af7e85d7d990faa2456cbdc66b23e58b71af7a3fa487fd9e021ffb6175f4edd3
+  data.tar.gz: 1bbacd96a15484f01b193394addcc354afb9b35364d9eedf388b0dfce1dd24dafefdc9b7fee46fb1862e5212a50bddb325e3fbe0c8c0808bc254527b2a2e86b7

data/CHANGELOG.md

@@ -5,6 +5,45 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.23.0](https://github.com/bamr87/zer0-mistakes/compare/v1.22.0...v1.23.0) (2026-06-30)
+
+
+### Features
+
+* **automation:** issue-triage→PR autopilot (off by default) ([#243](https://github.com/bamr87/zer0-mistakes/issues/243)) ([229e076](https://github.com/bamr87/zer0-mistakes/commit/229e07654915a9a0e401b30796c4f6c078eda926))
+* **automation:** verify-and-close lane — autopilot closes human issues fixed on main when CI is green ([#247](https://github.com/bamr87/zer0-mistakes/issues/247)) ([7cc7cb0](https://github.com/bamr87/zer0-mistakes/commit/7cc7cb0cdada7f64d59f46c2f4c3a7e88afbde6b))
+* **layouts:** add color_mode_default config knob with FOUC prevention ([#253](https://github.com/bamr87/zer0-mistakes/issues/253)) ([55bee97](https://github.com/bamr87/zer0-mistakes/commit/55bee970686c10a08aeed15bff43c3b66b5293e7))
+
+
+### Bug Fixes
+
+* **ci:** make claude-run truly OAuth-first — drop API key whenever an OAuth token is set ([#248](https://github.com/bamr87/zer0-mistakes/issues/248)) ([d2b44d2](https://github.com/bamr87/zer0-mistakes/commit/d2b44d2766f5c8543f4c5d8ddb79015e726f88fd))
+* **ci:** pass -R to gh pr view in the self-repair opt-in gate ([#260](https://github.com/bamr87/zer0-mistakes/issues/260)) ([67d67d7](https://github.com/bamr87/zer0-mistakes/commit/67d67d74146366afe6d495f529ba2c86a4513e18))
+* **includes:** existence-guard component-showcase demo links ([#219](https://github.com/bamr87/zer0-mistakes/issues/219)) ([#256](https://github.com/bamr87/zer0-mistakes/issues/256)) ([ef15e79](https://github.com/bamr87/zer0-mistakes/commit/ef15e79dc64db0dc7e721ca10bb7c1e826612473))
+* **layouts:** existence-gate /authors/ breadcrumb in author.html for remote-theme consumers ([#252](https://github.com/bamr87/zer0-mistakes/issues/252)) ([cae21a7](https://github.com/bamr87/zer0-mistakes/commit/cae21a7107b1875ac876f9e30cf71590ac7b0cc5))
+* **search:** existence-gate search modal form action for remote-theme consumers ([#257](https://github.com/bamr87/zer0-mistakes/issues/257)) ([b915c4d](https://github.com/bamr87/zer0-mistakes/commit/b915c4dead5eff3d6a2986720ebacdcf2bed5e33))
+* **skins:** map dark + contrast skins to their background assets ([#245](https://github.com/bamr87/zer0-mistakes/issues/245)) ([fb8808e](https://github.com/bamr87/zer0-mistakes/commit/fb8808e5ec754785b8239b01bccfab99569b70fa)), closes [#240](https://github.com/bamr87/zer0-mistakes/issues/240)
+
+## [Unreleased]
+
+### Bug Fixes
+
+* **includes:** existence-guard component-showcase demo links — breadcrumb and list-group items now render as real links when the target page exists in the build (`/docs/`, `/docs/customization/`, `/categories/`, `/tags/`) and as plain text when absent; removes inert `href="#"` / `onclick="return false;"` workaround ([#219](https://github.com/bamr87/zer0-mistakes/issues/219)) (evidence: [`test/visual/evidence/component-showcase/`](test/visual/evidence/component-showcase/README.md))
+
+### Tests
+
+* **navigation:** regression spec for section-sidebar /tags/ existence gate — asserts "Browse All Tags" and "View All Tags" links only render when /tags/ page is present in the build (issue #218, `test/visual/section-sidebar-tags-gate.spec.js`)
+### Features
+
+- **color_mode_default config knob** — new `color_mode_default` setting (`dark` | `light` | `auto`, default `auto`) in `_config.yml` controls Bootstrap's `data-bs-theme` both server-side (in `_layouts/root.html`) and client-side. An early inline script (`_includes/core/color-mode-init.html`, loaded before Bootstrap CSS) applies the correct theme before any `[data-bs-theme]` selector is evaluated, preventing FOUC. `localStorage["theme"]` (the Appearance panel override) always wins over the config default. `auto` follows `prefers-color-scheme` — backward-compatible with the previous behaviour. (evidence: [`test/visual/evidence/color-mode-default/`](test/visual/evidence/color-mode-default/README.md))
+### Bug Fixes
+
+* **search:** existence-gate search modal form action to `/sitemap/` only when that page is present in the build; falls back to `#` (safe no-op) for remote-theme Pages consumers without a `/sitemap/` stub (closes [#202](https://github.com/bamr87/zer0-mistakes/issues/202))
+* **layouts:** existence-gate `/authors/` breadcrumb link in author.html for remote-theme consumers ([#204](https://github.com/bamr87/zer0-mistakes/issues/204))
+### Tests
+
+* **tests:** add negative-path smoke tests for AI chat render guard — asserts FAB/panel are absent when `proxy_ready: false` and no `api_key` is set (closes #168)
+
 ## [1.22.0](https://github.com/bamr87/zer0-mistakes/compare/v1.21.0...v1.22.0) (2026-06-26)
 
 

data/_data/ai.yml

@@ -0,0 +1,10 @@
+# =============================================================================
+# _data/ai.yml — one place the AI model is configured for zer0-mistakes agents
+# -----------------------------------------------------------------------------
+# Read by .github/actions/claude-run (the issue-autopilot's AI step). Change the
+# model here and every autopilot agent call uses it. Auth is NOT here — it comes
+# from the CLAUDE_CODE_OAUTH_TOKEN (preferred) or ANTHROPIC_API_KEY secret.
+# =============================================================================
+provider: anthropic
+model: claude-opus-4-8
+max_tokens: 8000

data/_data/backlog.yml

@@ -62,8 +62,8 @@
 
 meta:
   title: "zer0-mistakes Backlog"
-  updated: 2026-06-26
-  next_id: 32
+  updated: 2026-06-29
+  next_id: 33
 
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
@@ -270,7 +270,7 @@ tasks:
 
   - id: T-010
     title: "Complete v1.9 quickstart docs rewrite with getting-started guide and screenshots"
-    status: open
+    status: done
     priority: P2
     area: docs
     risk: low
@@ -286,9 +286,9 @@ tasks:
       - "At least one guide beyond `bare-minimum.md` covers the standard fork/remote-theme workflow."
       - "Each guide includes at least one screenshot stored under `assets/images/docs/quickstart/`."
       - "All new pages pass `docs-validate.yml` front-matter and link checks."
-    links: { issue: null, pr: null, roadmap: "1.9" }
+    links: { issue: 126, pr: null, roadmap: "1.9" }
     created: 2026-06-01
-    updated: 2026-06-01
+    updated: 2026-06-29
 
   - id: T-011
     title: "Add Ruby unit tests for uncovered _plugins/ generators"
@@ -358,7 +358,7 @@ tasks:
 
   - id: T-013
     title: "Refresh Playwright snapshot baselines and re-arm the pixel gate"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -373,9 +373,9 @@ tasks:
       - "Baselines under `test/visual/snapshots/` regenerated and committed."
       - "`continue-on-error: true` removed from the snapshot step in `ci.yml`."
       - "Snapshot tier passes in CI on an unchanged follow-up commit."
-    links: { issue: null, pr: null, roadmap: "1.13" }
+    links: { issue: 135, pr: null, roadmap: "1.13" }
     created: 2026-06-10
-    updated: 2026-06-10
+    updated: 2026-06-29
 
   - id: T-014
     title: "Re-arm the docs link-check gate (remove warn-only || true)"
@@ -538,7 +538,7 @@ tasks:
 
   - id: T-020
     title: "CI coverage for installer interactive wizard and upgrade path (coverage rank #2)"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -554,13 +554,13 @@ tasks:
       - "Wizard prompt helpers exercised non-interactively (piped answers) in a test_install_* suite."
       - "An upgrade fixture covers detect→migrate→verify for at least one version gap."
       - "Suites run in CI via the standard installer e2e discovery (test_install_*.sh)."
-    links: { issue: null, pr: null, roadmap: "1.14" }
+    links: { issue: 147, pr: null, roadmap: "1.14" }
     created: 2026-06-12
-    updated: 2026-06-12
+    updated: 2026-06-29
 
   - id: T-021
     title: "Vendor cytoscape.js so the Obsidian graph works without a CDN"
-    status: open
+    status: done
     priority: P3
     area: feat
     risk: standard
@@ -577,9 +577,9 @@ tasks:
       - "cytoscape.min.js committed under assets/vendor/ and referenced via a local path."
       - "full-graph.html no longer references cdn.jsdelivr.net."
       - "The graph page renders nodes/edges with the vendored file (no network)."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 152, pr: null, roadmap: null }
     created: 2026-06-13
-    updated: 2026-06-13
+    updated: 2026-06-29
 
   # --- 2026-06-15 audit -------------------------------------------------------
 
@@ -637,7 +637,7 @@ tasks:
 
   - id: T-024
     title: "Unit tests for scripts/content-review.rb scoring engine"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -657,13 +657,13 @@ tasks:
       - "At least one test verifies the `--strict` flag exits non-zero when the fail threshold is crossed."
       - "Tests run under `LC_ALL=C` (locale-independence parity with T-015 guard)."
       - "`./scripts/bin/test` stays green with the new tests included."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 166, pr: null, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
 
   - id: T-025
     title: "Playwright smoke tests for the site-wide search modal"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -683,13 +683,13 @@ tasks:
       - "A result-population check: query matching a known post title (e.g. 'Hello World') yields at least one result `<a>` element."
       - "Mutual-exclusion guard: opening search while Settings offcanvas is open closes the offcanvas first (no stacked backdrops)."
       - "Spec runs in the smoke project (`npx playwright test --project=smoke`) without a network request to an external index."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 167, pr: 208, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
 
   - id: T-026
     title: "Playwright smoke test for AI chat widget render guard and FAB visibility"
-    status: open
+    status: done
     priority: P3
     area: tests
     risk: standard
@@ -710,9 +710,9 @@ tasks:
       - "A mock-config test (inject `data-ai-chat-enabled` attribute or use a fixture page with the widget force-enabled) verifies the FAB renders and the chat panel toggles open/closed on click."
       - "The test passes in the smoke project without a live AI backend."
       - "`./scripts/bin/test` (including the Playwright smoke tier) stays green."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 168, pr: 250, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
 
   # --- Issue intake 2026-06-26: remote-theme 404 cluster + docs ----------------
   # Cap: 5 of 7 open issues triaged this run. Deferred (next run): #203 (consumer
@@ -721,7 +721,7 @@ tasks:
 
   - id: T-027
     title: "Theme chrome injects unconditional links (/authors/, /news/, /tags/, /posts/, graph) that 404 for remote-theme consumers"
-    status: open
+    status: done
     priority: P2
     area: a11y
     risk: standard
@@ -740,13 +740,13 @@ tasks:
       - "Theme-injected chrome links render only when their target exists (mirror the footer Quick-Links existence guard)."
       - "A link check over a built remote-theme `_site` reports no theme-injected 404s."
       - "No edit to `lib/jekyll-theme-zer0/version.rb` or release files."
-    links: { issue: 204, pr: null, roadmap: null }
+    links: { issue: 204, pr: 252, roadmap: null }
     created: 2026-06-26
-    updated: 2026-06-26
+    updated: 2026-06-29
 
   - id: T-028
     title: "remote_theme Pages consumers 404 on /search.json and /sitemap/ (generator is plugin-only)"
-    status: open
+    status: done
     priority: P2
     area: feat
     risk: standard
@@ -764,13 +764,13 @@ tasks:
       - "On a remote-theme Pages build, the navbar search resolves (no /search.json 404) or degrades gracefully."
       - "The /sitemap/ link resolves (no 404) for a remote-theme consumer."
       - "No new runtime dependency; no edit to version/release files."
-    links: { issue: 202, pr: null, roadmap: null }
+    links: { issue: 202, pr: 257, roadmap: null }
     created: 2026-06-26
-    updated: 2026-06-26
+    updated: 2026-06-29
 
   - id: T-029
     title: "Guard the unconditional /tags/ link in section-sidebar.html for remote-theme consumers"
-    status: open
+    status: done
     priority: P2
     area: feat
     risk: low
@@ -786,13 +786,13 @@ tasks:
       - "The sidebar 'View All Tags' link renders only when the tags index exists (or a documented site flag is set)."
       - "Remote-theme consumers no longer 404 from the sidebar link; the Jekyll build stays green."
       - "A `test/visual/*.spec.js` regression asserts the conditional render (theme-ui / visual-evidence)."
-    links: { issue: 218, pr: null, roadmap: null }
+    links: { issue: 218, pr: 254, roadmap: null }
     created: 2026-06-26
-    updated: 2026-06-26
+    updated: 2026-06-29
 
   - id: T-030
     title: "component-showcase.html hardcodes demo links (/docs/, /pages/, /docs/customization/) that 404 for consumers"
-    status: open
+    status: done
     priority: P3
     area: feat
     risk: low
@@ -809,13 +809,13 @@ tasks:
       - "The showcase's demo links are parameterized or existence-guarded (no hardcoded absolute paths that can 404)."
       - "Including the showcase on a consumer site produces no theme-injected 404s; the Jekyll build stays green."
       - "A `test/visual/*.spec.js` regression covers the parameterized/guarded links (theme-ui / visual-evidence)."
-    links: { issue: 219, pr: null, roadmap: null }
+    links: { issue: 219, pr: 256, roadmap: null }
     created: 2026-06-26
-    updated: 2026-06-26
+    updated: 2026-06-29
 
   - id: T-031
     title: "Document the safe-mode build-overlay recipe for consumers building outside GitHub Pages"
-    status: open
+    status: done
     priority: P3
     area: docs
     risk: low
@@ -832,6 +832,34 @@ tasks:
       - "A docs page/section under `pages/_docs/` documents the build-overlay recipe (clone -> overlay -> strip _plugins -> strict build)."
       - "It is cross-linked from the remote-theme/deploy docs and passes markdownlint + the content-review deterministic tier."
       - "No code change; docs only."
-    links: { issue: 220, pr: null, roadmap: null }
+    links: { issue: 220, pr: 251, roadmap: null }
     created: 2026-06-26
     updated: 2026-06-26
+
+  - id: T-032
+    title: "Add color_mode_default config knob (dark|light|auto) with FOUC prevention"
+    status: done
+    priority: P2
+    area: feat
+    risk: low
+    effort: S
+    source: issue
+    route: theme-ui
+    summary: >-
+      Implement a color_mode_default config key (values dark|light|auto, default auto).
+      Server-side: root.html reads site.color_mode_default and sets data-bs-theme
+      accordingly (auto resolves to dark as SSR fallback). Client-side: an early inline
+      script (_includes/core/color-mode-init.html, before Bootstrap CSS) applies the
+      correct theme respecting both the config default and a localStorage["theme"] override,
+      preventing FOUC. auto follows prefers-color-scheme — backward-compatible.
+    acceptance:
+      - "site.color_mode_default: dark|light|auto is documented in _config.yml."
+      - "root.html server-renders data-bs-theme from the config (not hardcoded 'dark')."
+      - "An early inline script before Bootstrap CSS prevents FOUC for all three modes."
+      - "localStorage['theme'] override wins over the config default."
+      - "auto follows prefers-color-scheme; backward-compatible with the previous behaviour."
+      - "Regression spec test/visual/color-mode-default.spec.js passes (smoke tier)."
+      - "Before/after evidence committed under test/visual/evidence/color-mode-default/."
+    links: { issue: 241, pr: 253, roadmap: null }
+    created: 2026-06-29
+    updated: 2026-06-29

data/_data/navigation/docs.yml

@@ -70,6 +70,10 @@
       url: /docs/deployment/
     - title: GitHub Pages
       url: /docs/deployment/github-pages/
+    - title: Remote-Theme Consumer Checklist
+      url: /docs/deployment/remote-theme-checklist/
+    - title: Safe-Mode Build Overlay
+      url: /docs/deployment/build-overlay/
     - title: Netlify
       url: /docs/deployment/netlify/
     - title: Custom Domain

data/_data/theme_backgrounds.yml

@@ -99,3 +99,27 @@ skins:
     gradient: "assets/backgrounds/gradients/sunrise.svg"
     pattern: "assets/backgrounds/patterns/sunrise.svg"
     noise: "assets/backgrounds/noise/sunrise.svg"
+
+  # `dark` is the DEFAULT theme_skin, and `contrast` is advertised as valid, but
+  # neither was mapped here — so the SVG-background feature had no entry for them
+  # (issue #240). The gradient/pattern/noise assets already ship; these entries
+  # wire them up. Colors are taken from each skin's gradient stops.
+  dark:
+    label: "Dark"
+    colors:
+      primary: "#1a1a2e"
+      secondary: "#16213e"
+      accent: "#0f3460"
+    gradient: "assets/backgrounds/gradients/dark.svg"
+    pattern: "assets/backgrounds/patterns/dark.svg"
+    noise: "assets/backgrounds/noise/dark.svg"
+
+  contrast:
+    label: "Contrast"
+    colors:
+      primary: "#111111"
+      secondary: "#333333"
+      accent: "#ffcc00"
+    gradient: "assets/backgrounds/gradients/contrast.svg"
+    pattern: "assets/backgrounds/patterns/contrast.svg"
+    noise: "assets/backgrounds/noise/contrast.svg"

data/_includes/components/component-showcase.html

@@ -25,11 +25,12 @@
   - Bootstrap 5.3 CSS & JS (loaded by theme)
   - Bootstrap Icons (loaded by theme)
 
-  Note: The breadcrumb and list-group links are DEMO links only — they are
-        intentionally inert (href="#" with onclick="return false;") so the
-        showcase never injects site-absolute paths (/docs/, /pages/, ...) that
-        would 404 on consumer sites that lack those exact routes (issue #219).
-        Do not point them at absolute paths.
+  Note: The breadcrumb and list-group demo links are existence-guarded (issue #219).
+        Each target URL is resolved against site.html_pages (and collection docs
+        for collection-backed routes). When the page exists in the build the link
+        is real; when it does not the label renders as plain text. This keeps the
+        showcase safe for remote-theme consumers who may lack /docs/, /posts/,
+        /categories/, /tags/, or /docs/customization/.
   ===================================================================
 -->
 {% assign sections = include.sections | default: "alerts,buttons,badges,cards,accordion,tabs,progress,breadcrumbs,table,tooltips,list-group" %}
@@ -326,11 +327,29 @@ theme: jekyll-theme-zer0</code></pre>
 <!-- ===== BREADCRUMBS ===== -->
 <h3 id="showcase-breadcrumbs">Breadcrumbs</h3>
 <p>Hierarchical navigation trail showing current page position:</p>
+{% comment %} Existence-guard the demo breadcrumb links so they never 404 on
+   remote-theme consumers that lack /docs/ or /docs/customization/. When the
+   target page is in the build the crumb is a real link; otherwise plain text.
+   Home (/) is always present. Pattern mirrors _includes/navigation/breadcrumbs.html. {% endcomment %}
+{% assign _demo_docs_page = site.html_pages | where: "url", "/docs/" | first %}
+{% unless _demo_docs_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_docs_page = _col.docs | where: "url", "/docs/" | first %}
+    {% if _demo_docs_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_custom_page = site.html_pages | where: "url", "/docs/customization/" | first %}
+{% unless _demo_custom_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_custom_page = _col.docs | where: "url", "/docs/customization/" | first %}
+    {% if _demo_custom_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
 <nav aria-label="breadcrumb example" class="mb-4">
   <ol class="breadcrumb">
-    <li class="breadcrumb-item"><a href="#" class="text-decoration-none" onclick="return false;"><i class="bi bi-house me-1"></i>Home</a></li>
-    <li class="breadcrumb-item"><a href="#" class="text-decoration-none" onclick="return false;">Documentation</a></li>
-    <li class="breadcrumb-item"><a href="#" class="text-decoration-none" onclick="return false;">Customization</a></li>
+    <li class="breadcrumb-item"><a href="{{ '/' | relative_url }}" class="text-decoration-none"><i class="bi bi-house me-1"></i>Home</a></li>
+    <li class="breadcrumb-item">{% if _demo_docs_page %}<a href="{{ '/docs/' | relative_url }}" class="text-decoration-none">Documentation</a>{% else %}Documentation{% endif %}</li>
+    <li class="breadcrumb-item">{% if _demo_custom_page %}<a href="{{ '/docs/customization/' | relative_url }}" class="text-decoration-none">Customization</a>{% else %}Customization{% endif %}</li>
     <li class="breadcrumb-item active" aria-current="page">Theme Colors</li>
   </ol>
 </nav>
@@ -419,25 +438,67 @@ document.addEventListener('DOMContentLoaded', () => {
 <!-- ===== LIST GROUP ===== -->
 <h3 id="showcase-list-group">List Group</h3>
 <p>Organized content lists with icons, badges, and action states:</p>
+{% comment %} Existence-guard the demo list-group links (issue #219). Each target
+   URL is resolved against site.html_pages + collection docs. When present the
+   item is a real <a>; when absent it renders as a non-linking <div> so no 404
+   is injected on remote-theme consumers that lack /posts/, /docs/, /categories/,
+   or /tags/. Pattern mirrors section-sidebar.html and author-bio.html. {% endcomment %}
+{% assign _demo_posts_page = site.html_pages | where: "url", "/posts/" | first %}
+{% unless _demo_posts_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_posts_page = _col.docs | where: "url", "/posts/" | first %}
+    {% if _demo_posts_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_cats_page = site.html_pages | where: "url", "/categories/" | first %}
+{% unless _demo_cats_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_cats_page = _col.docs | where: "url", "/categories/" | first %}
+    {% if _demo_cats_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_tags_page = site.html_pages | where: "url", "/tags/" | first %}
+{% unless _demo_tags_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_tags_page = _col.docs | where: "url", "/tags/" | first %}
+    {% if _demo_tags_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
 <div class="row g-4 mb-4">
   <div class="col-md-6">
     <div class="list-group">
-      <a href="#" onclick="return false;" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_posts_page %}
+      <a href="{{ '/posts/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-journal-richtext text-primary me-2"></i>Blog Posts</span>
         <span class="badge bg-primary rounded-pill">{{ site.posts.size | default: "12" }}</span>
-      </a>
-      <a href="#" onclick="return false;" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_posts_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_docs_page %}
+      <a href="{{ '/docs/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-book text-success me-2"></i>Documentation</span>
         <span class="badge bg-success rounded-pill">{{ site.documents.size | default: "8" }}</span>
-      </a>
-      <a href="#" onclick="return false;" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_docs_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_cats_page %}
+      <a href="{{ '/categories/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-collection text-info me-2"></i>Categories</span>
         <span class="badge bg-info rounded-pill">{{ site.categories.size | default: "6" }}</span>
-      </a>
-      <a href="#" onclick="return false;" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_cats_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_tags_page %}
+      <a href="{{ '/tags/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-tags text-warning me-2"></i>Tags</span>
         <span class="badge bg-warning text-dark rounded-pill">{{ site.tags.size | default: "24" }}</span>
-      </a>
+      {% if _demo_tags_page %}</a>{% else %}</div>{% endif %}
     </div>
   </div>
   <div class="col-md-6">

data/_includes/components/search-modal.html

@@ -2,19 +2,43 @@
   ===================================================================
   SEARCH MODAL - Site-wide Search Popup
   ===================================================================
-  
+
   File: search-modal.html
   Path: _includes/components/search-modal.html
   Purpose: Provide a modal search experience with keyboard shortcut support
-  
+
   Notes:
-  - Uses /sitemap/ for query-based search results
+  - Form action targets /sitemap/ when that page exists in the build;
+    falls back to /sitemap.xml if available, otherwise '#' (safe no-op).
+    JS (search-modal.js) always intercepts submit and keeps results
+    in-modal, so the action is only a no-JS fallback.  The gate here
+    prevents a dead link on remote-theme Pages builds that lack /sitemap/.
   - Keyboard shortcut handled by navigation keyboard module ("/")
   ===================================================================
 -->
 
 {%- assign ui_text = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
 {%- assign search_placeholder = ui_text.search_placeholder_text | default: "Enter your search term..." -%}
+{%- comment -%}
+  Existence-gate the form action to /sitemap/ only when that page is present
+  in the build (mirroring the footer Quick Links guard, and the section-sidebar
+  /tags/ gate).  Remote-theme Pages consumers that haven't committed a /sitemap/
+  stub get a safe '#' fallback; the JS always intercepts submit anyway, so this
+  only affects the no-JS code path.
+{%- endcomment -%}
+{%- assign _search_sitemap_url  = "/sitemap/" -%}
+{%- assign _search_sitemap_page = site.html_pages | where: "url", _search_sitemap_url | first -%}
+{%- unless _search_sitemap_page -%}
+  {%- for col in site.collections -%}
+    {%- assign _search_sitemap_page = col.docs | where: "url", _search_sitemap_url | first -%}
+    {%- if _search_sitemap_page -%}{%- break -%}{%- endif -%}
+  {%- endfor -%}
+{%- endunless -%}
+{%- if _search_sitemap_page -%}
+  {%- assign _search_form_action = "/sitemap/" | relative_url -%}
+{%- else -%}
+  {%- assign _search_form_action = "#" -%}
+{%- endif -%}
 
 <div class="modal fade search-modal" id="siteSearchModal" tabindex="-1" aria-labelledby="siteSearchModalLabel" aria-hidden="true">
     <div class="modal-dialog modal-dialog-centered">
@@ -26,7 +50,7 @@
                 <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
             </div>
             <div class="modal-body">
-                <form action="{{ '/sitemap/' | relative_url }}" method="get" data-search-form>
+                <form action="{{ _search_form_action }}" method="get" data-search-form>
                     <label class="visually-hidden" for="site-search-input">Search</label>
                     <div class="input-group">
                         <span class="input-group-text">

data/_includes/core/color-mode-init.html

@@ -0,0 +1,35 @@
+{%- comment -%}
+  Component:   color-mode-init
+  Path:        _includes/core/color-mode-init.html
+  Purpose:     Early inline script that applies data-bs-theme BEFORE Bootstrap CSS
+               loads, preventing FOUC (flash of unstyled/wrong-themed content).
+  Params:      none — reads data-color-mode-default from the <html> element,
+               which root.html sets from site.color_mode_default.
+  Depends on:  root.html (sets data-color-mode-default attribute server-side)
+  Notes:       Must be included BEFORE any Bootstrap CSS link tag. The script
+               is tiny, synchronous, and runs inline before the browser requests
+               external stylesheets, so the correct theme is already applied
+               when Bootstrap's [data-bs-theme] selectors are first evaluated.
+
+  Priority order (highest → lowest):
+    1. localStorage["theme"]    — user's explicit override via Appearance panel
+    2. data-color-mode-default  — site.color_mode_default config value
+    3. "auto" fallback          — resolves via prefers-color-scheme
+{%- endcomment -%}
+<script>
+(function () {
+  'use strict';
+  try {
+    var root = document.documentElement;
+    var configDefault = root.getAttribute('data-color-mode-default') || 'auto';
+    var stored = window.localStorage.getItem('theme');
+    var mode = stored || configDefault;
+    if (mode === 'auto') {
+      root.setAttribute('data-bs-theme',
+        window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
+    } else {
+      root.setAttribute('data-bs-theme', mode);
+    }
+  } catch (e) { /* localStorage / matchMedia unavailable — server-rendered value stands */ }
+})();
+</script>

data/_includes/core/head.html

@@ -127,6 +127,15 @@ window.MathJax = {
 <!-- CSS FRAMEWORKS AND LIBRARIES   -->
 <!-- ================================ -->
 
+<!-- ========================== -->
+<!-- COLOR MODE INIT (FOUC FIX) -->
+<!-- ========================== -->
+<!-- Must run BEFORE Bootstrap CSS so the correct data-bs-theme is applied
+     when [data-bs-theme=dark/light] selectors are first evaluated.
+     Reads site.color_mode_default (via data-color-mode-default attr on <html>)
+     and falls back to localStorage["theme"] for the user's explicit preference. -->
+{% include core/color-mode-init.html %}
+
 <!-- ========================== -->
 <!-- BOOTSTRAP 5 FRAMEWORK     -->
 <!-- ========================== -->

data/_includes/core/tokens-inline.html

@@ -35,6 +35,11 @@
 {%- endif -%}
 
 {%- comment -%}
+  NOTE: The data-bs-theme FOUC-prevention script lives in
+  _includes/core/color-mode-init.html (included from head.html BEFORE Bootstrap
+  CSS) so the correct theme is applied before any [data-bs-theme] selectors are
+  evaluated. Do not duplicate it here.
+
   Restore any user-saved Appearance overrides before paint to avoid a flash
   of the default palette. The Appearance panel (Track 6) writes JSON like
   {"primary":"#ff5722"} to localStorage["zer0-appearance"].