themes-scifi-clean/RECOMMENDED_FONTS.md
Alex Dunmow 96b87b3e81 initial: theme plugin scifi-clean
Bootstrapped during the 2026-06-06 BlockNinja consolidation. Was previously
an unversioned directory inside ~/src/blockninja-themes/scifi-clean.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-06 14:11:43 +08:00

34 lines
1.9 KiB
Markdown

# Recommended fonts for Sci-Fi Clean
This theme ships `fonts.json = []` — no woff2 files bundled in this implementation pass.
Add the fonts below from the site admin's Google Fonts picker.
Open **Admin → Settings → Typography**, switch to the **Google Fonts** tab, and assign:
| Slot | Pick | Source | Notes |
|----------|---------------------------------------|----------------|---------------------------------------------------------|
| Heading | `Space Grotesk` (weights 400, 500, 700) | `google:Space Grotesk` | Geometric display face. Spec §3 calls it "the safe ship default" over Eurostile. |
| Body | `Inter` (weights 400, 500, 600) | `google:Inter` | Workhorse UI sans. Pairs cleanly with Space Grotesk. |
| Mono | `JetBrains Mono` (weights 400, 500) | `google:JetBrains Mono` | Used for every numeral, identifier, and tabular figure. |
All three are in the curated Google Fonts list; no upload is required.
## CSS fallback stacks
Until the admin assigns fonts, templates fall through to these CSS-variable fallbacks
(declared in the theme's CSS manifest, applied to `:root`):
- `--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`
The fallback stacks intentionally already approximate the intended aesthetic, so the
theme looks right out of the box even before the admin picks Google Fonts.
## Why no bundled woff2s in this pass
Per `themes/docs/FONTS.md` (wave-1 policy): no theme bundles woff2 files in this
implementation pass. Wave-2 may bundle commercial display faces (e.g. Eurostile)
once licensing for `.so` redistribution is sorted; until then, Space Grotesk is
the canonical heading face for Sci-Fi Clean.