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>
34 lines
1.9 KiB
Markdown
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.
|