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

1.9 KiB

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.