themes-scifi-clean/RECOMMENDED_FONTS.md
Alex Dunmow 46c9177265 feat(scifi-clean): Wave A theme — 49 overrides, 7 templates, persona blocks, seed
WO-TF-024. Re-skin from frozen Wave-0 builtins into blueprint/HUD/mono chrome
(AI/robotics product persona), preserving every content field, provider field,
custom tag, and JS block; button/card legacy field reads reconciled per §4.

- 49 mandatory template_overrides + 7 page templates (default, full-width,
  landing, article, blog-index, contact, auth) with MID-tier motion
  (JS scroll-reveal + ticking counters + CSS line-draw; reduced-motion + no-JS
  static fallback).
- 4 persona blocks: tech_spec, benchmark_table, telemetry_grid,
  changelog_console. Deleted 5 builtin-duplicating theme blocks (now overrides).
- 4 dual-mode presets (19 tokens, light + dark tuned).
- Bundled OFL fonts (Space Grotesk / Inter / JetBrains Mono) + LICENSES.
- Email-safe wrapper retuned; master pages + seed demo site (Halcyon Robotics:
  home, about, blog x3, contact with data-table + row_inserted email workflow,
  login).
- required_icon_packs (lucide, simple-icons) + RECOMMENDED docs.

make build exit 0 (codeless .bnp); check-safety exit 0.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 12:43:47 +08:00

33 lines
1.7 KiB
Markdown

# Recommended fonts for Sci-Fi Clean
This theme **bundles** its type. `fonts.json` ships latin-subset woff2 files in
`assets/fonts/` (all SIL OFL 1.1 — see `assets/fonts/LICENSES.md`), so the
intended aesthetic renders out of the box with no admin setup.
| Slot | Bundled family | Weights | Role |
|---------|---------------------|-----------|---------------------------------------------------|
| Heading | `Space Grotesk` | 500, 700 | Geometric display face for headlines and brand. |
| Body | `Inter` | 400, 600 | Workhorse UI sans for prose and controls. |
| Mono | `JetBrains Mono` | 400, 500 | Every numeral, identifier, readout, and spec row. |
The bundled families appear as `source=template` rows in **Admin → Settings →
Typography**. Fonts stay admin-controlled: an admin can override any slot from
the Google Fonts tab or an upload, and the theme follows because every
`font-family` goes through `var(--font-heading|body|mono, <fallback>)`.
## CSS fallback stacks
Until (or unless) the admin reassigns a slot, templates fall through to these
CSS-variable fallbacks (declared on `:root` in the theme CSS manifest):
- `--font-heading` -> `"Space Grotesk", "Inter", "Helvetica Neue", Helvetica, Arial, sans-serif`
- `--font-body` -> `"Inter", "Helvetica Neue", Helvetica, Arial, sans-serif`
- `--font-mono` -> `"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`
## Good alternates
If an admin prefers to swap the mono readout face, `Space Mono` (OFL) and
`IBM Plex Mono` (OFL) both hold tabular numerals well. For headings, `Sora`
(OFL) is a close geometric cousin of Space Grotesk. All are in the curated
Google Fonts list; no upload required.