Skip to content

Redesign site on Hugo Blox documentation template#1

Merged
jt55401 merged 1 commit into
mainfrom
redesign/hugo-blox
May 13, 2026
Merged

Redesign site on Hugo Blox documentation template#1
jt55401 merged 1 commit into
mainfrom
redesign/hugo-blox

Conversation

@jt55401
Copy link
Copy Markdown
Contributor

@jt55401 jt55401 commented May 13, 2026

Summary

Rebuilds the site on Hugo Blox / Tailwind v4, mirroring the slideshow's narrative arc. The Ananke theme and its custom partials are replaced.

  • Homepage — pitch hero → quick stats → the problem → what we are not → five principles → standards comparison table → CTA
  • /spec/<signed-section> element, two-stage canonicalization (HTML→text + 8-phase text), key resolution, endorsements, two-layer trust model
  • /architecture/ — five mermaid diagrams (full system, two layers, author flow, reader flow, domain binding)
  • /implementation/ — reference impls, code samples, status table, open design questions
  • /use-cases/, /faq/ — ported and tightened
  • /blog/paper-published/ — paper announcement, credited to Jason (byline links externally to jason-grey.com)

Theme customizations

  • data/authors/jason.yaml — owner profile w/ external_url to jason-grey.com
  • layouts/_partials/page_author_card.html — overrides the Blox byline to honor external_url
  • assets/js/hb-mermaid-config.js — overrides Blox's default mermaid config (which broke against Tailwind v4 oklch colors) with a static dark-friendly palette matching the deck
  • config/_default/params.yaml — HTMLTrust branding, dark mode default, teal primary, organization identity

Build chain changes

  • .gitignore — add node_modules, hugo_stats.json
  • .github/workflows/ci.yml — add Setup Go + Setup Node + npm install; build search index with pagefind; skip the signed-section verification for now (the new Hugo Blox build does not yet apply <signed-section> wrappers — TODO marker left in the workflow to re-wire signing later)

Test plan

  • CI build passes on this PR (Hugo + npm + Pagefind)
  • Eyeball the deployed preview (Cloudflare Pages preview URL on PR)
  • After merge: confirm Cloudflare prod deploy succeeds
  • After merge: open follow-up to re-integrate <signed-section> signing into the Hugo Blox build

🤖 Generated with Claude Code

Replaces the Ananke-based site with a Hugo Blox / Tailwind v4 stack.
The homepage now mirrors the slideshow's narrative arc: pitch hero,
quick stats, the problem we solve, what we are not, five principles,
a standards-alignment comparison table, and a closing CTA.

Pages:
  /             pitch hero + deck-flow scroll
  /spec/        signed-section element, attributes, two-stage
                canonicalization (HTML→text + 8-phase text), key
                resolution, endorsements, two-layer trust model
  /architecture/ five mermaid diagrams: full system, two layers,
                author flow, reader flow, domain binding
  /implementation/ reference impls, code samples, status table,
                open design questions
  /use-cases/   ported and tightened
  /faq/         ported and tightened
  /blog/paper-published/  paper announcement, credited to Jason

Theme customizations:
  - data/authors/jason.yaml — owner profile w/ external_url to
    jason-grey.com; byline links externally via overridden
    layouts/_partials/page_author_card.html
  - assets/js/hb-mermaid-config.js — overrides Blox's default
    mermaid config (which broke against Tailwind v4 oklch colors)
    with static dark-friendly palette matching the deck
  - config/_default/params.yaml — HTMLTrust branding, dark mode
    default, teal primary, organization identity, footer credit

Build chain:
  - .gitignore: add node_modules and hugo_stats.json
  - CI: add Setup Go + Setup Node + npm install; build search
    index with pagefind; skip signed-section verification until
    signing is re-wired into the Hugo Blox build (TODO marker
    left in workflow)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jt55401 jt55401 force-pushed the redesign/hugo-blox branch from 5d1a3bf to d412d7e Compare May 13, 2026 22:09
@jt55401 jt55401 merged commit bf16e17 into main May 13, 2026
2 checks passed
@jt55401 jt55401 deleted the redesign/hugo-blox branch May 13, 2026 22:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant