themes-brutalist/RECOMMENDED_FONTS.md
Alex Dunmow 6c03f6da6c feat(brutalist): Wave A override contract — 49 builtin overrides, 7 templates, seed
WO-TF-012. Neo-brutalist creative-studio theme brought up to the Wave A
OVERRIDE-CONTRACT (frozen against cms a0f07e2ae).

- Override all 49 mandatory builtin keys in templates/overrides/brutalist/
  (chrome, marketing, primitives, commerce, blog family, auth surface, 404),
  each carrying the brutalist chrome (chunky borders, hard offset shadows,
  hover snap, mono uppercase meta, candy accents) via a raw-CSS "bru-*" kit
  shipped in manifest.yaml. Load-bearing wiring (HTMX auth endpoints, signup
  form, contact-form submit + honeypot, facade scripts, lightbox) preserved
  verbatim.
- 7 page templates: default, full-width, landing, article, blog-index,
  contact, auth (fixed a bug where templates omitted the `dark` class so dark
  presets never activated).
- Blocks rework: removed 6 blocks that duplicated builtins (masthead,
  concrete_hero, meta_strip, caption_image, pull_quote, colophon) — now
  overrides; kept project_ledger; added persona blocks sticker_wall,
  changelog, spec_sheet (4 total).
- 4 dual-mode presets (all mode "both", 19 tokens light + dark): Concrete &
  Cadmium, Hazard, Riso, Acid.
- Bundled 8 latin-subset OFL woff2 (Space Grotesk, Archivo Black, Inter, IBM
  Plex Mono) in assets/fonts/ + LICENSES.md; fonts.json populated; all
  font-family via var(--font-*). RECOMMENDED_FONTS/ICONS updated;
  required_icon_packs declared.
- Email-safe themed wrapper (tables, inline styles) cleaned up.
- master_pages.json reworked to builtin navbar/hero/cta/footer.
- Demo seed (seed/seed.json + workflows.json, demo:true): home, about, blog
  (3 posts), contact (form + contact_submissions data table + row_inserted →
  email-admins workflow), login — studio voice.

Known codeless limitation: page-suggestions renders themed 404 chrome but the
similar-pages list (server-side DB query, no template provider) can't be
reproduced; auth-form captcha widget is server-generated and can't be emitted
(seed leaves captchaEnabled=false). Verified: make exit 0; check-safety
exit 0. Visual quality UNVERIFIED until Wave B.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 10:56:49 +08:00

1.5 KiB

Recommended fonts — Brutalist

Fonts are admin-controlled. Assign them in Admin → Appearance → Typography; the theme consumes them only via var(--font-heading|body|mono, <fallback>), never a hardcoded family.

Bundled (ship with this theme, SIL OFL 1.1)

These latin-subset woff2 files are bundled in assets/fonts/ and appear in the picker as source=template rows (see assets/fonts/LICENSES.md):

Role Family Weights Notes
Heading Space Grotesk 500, 700 The signature display face — oversized, uppercase.
Display (alt) Archivo Black 400 Heavier alternative for masthead-scale headlines.
Body Inter 400, 500, 700 Neutral, high-legibility body copy.
Mono IBM Plex Mono 400, 500 Meta labels, captions, buttons, tags.

Suggested assignment

  • Heading: Space Grotesk (700). Alternative: Archivo Black for maximum weight.
  • Body: Inter (400).
  • Mono: IBM Plex Mono (400). Alternative from the Google tab: JetBrains Mono.

Fallback stacks (used when no admin font is set)

  • Heading: "Space Grotesk", "Inter Tight", "Helvetica Neue", Helvetica, Arial, sans-serif
  • Body: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif
  • Mono: "JetBrains Mono", "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace

All four bundled families are SIL Open Font License 1.1. Swap freely from the Google Fonts tab; the theme only references the CSS variables.