themes-brutalist/RECOMMENDED_ICONS.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

22 lines
951 B
Markdown

# Recommended icons — Brutalist
This theme renders icons through the sprite pipeline
(`<svg><use href="/icons/<pack>.svg#<name>"></use></svg>`). Two packs are used by
the theme's block overrides and are declared in `plugin.mod`
(`required_icon_packs = ["lucide", "simple-icons"]`).
Until the loader auto-installs declared packs, install them manually before
activation:
1. Open `/admin/icons`.
2. Install **Lucide** (bundled — usually already present). Used for UI chrome:
`menu`, `x`, `chevron-down`, `chevron-left`, `chevron-right`, `arrow-right`,
`play`, `download`, `check`, `star`, `navigation`, `map-pin`, `flag`, `globe`,
`asterisk`.
3. Install **Simple Icons** (bundled). Used by the author-bio-hero social row:
`x`, `linkedin`, `github`.
`lucide` is the safe default for any icon-picker field. Utility-bar and footer
social icons render whatever `pack:name` string the admin assigns, so they work
with any installed pack.