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

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

48 lines
1.8 KiB
Markdown

# Earthen — recommended fonts
This theme ships `fonts.json = []` per the wave-1 fonts policy
(see `themes/docs/FONTS.md`). The CSS uses
`var(--font-heading)` / `var(--font-body)` / `var(--font-mono)` with a
fallback stack so the page reads close to the intended aesthetic before
the admin assigns fonts.
Configure these in the admin Typography panel to match the spec's
intended look.
## Display / heading — assign to `Heading`
Primary pick:
- **Fraunces** — Source: `google:Fraunces`.
Open the Typography panel, switch to the Google Fonts tab, search
"Fraunces", click Add, then assign to Heading. (OFL, free to host.)
Spec-preferred display face (commercial):
- **Recoleta** — Source: `upload:Recoleta`.
Recoleta is a commercial face from Latinotype. Purchase the desktop +
webfont licence, upload the woff2 in the Fonts panel, then assign to
Heading. Until then Fraunces is the fallback used by the theme CSS.
## Body — assign to `Body`
- **Spectral** — Source: `google:Spectral`.
Open the Typography panel, Google Fonts tab, search "Spectral",
click Add, assign to Body. (OFL, free to host.)
## Mono / data captions — assign to `Mono`
- **JetBrains Mono** — Source: `google:JetBrains Mono`.
Open the Typography panel, Google Fonts tab, search "JetBrains Mono",
click Add, assign to Mono. (OFL, free to host.)
## Notes
- All three Google-Font picks are part of the curated picker list.
No manual upload required for the OFL families.
- A future build pass may bundle Recoleta woff2s directly via a
populated `fonts.json` once the licence is confirmed.
- The CSS fallback stack inside the theme (`"Fraunces", "Playfair Display",
Georgia, serif` for headings; `"Spectral", Georgia, serif` for body)
keeps the moss/clay character visible during the cold-load window.