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

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

32 lines
1.5 KiB
Markdown

# Recommended fonts — Terminal theme
This theme ships `fonts.json = []` per the wave-1 implementation policy in `docs/FONTS.md`. The intended typography is **all monospace, no exceptions**. The CSS fallback chain ends in `monospace` so the theme remains legible before an admin picks fonts; the recommendations below match the spec's intended look.
Fonts are admin-configured through the typography panel. Open the Google Fonts tab of the picker, add each family, then assign it to the appropriate slot.
## Heading & mono — JetBrains Mono
- **Source recommendation:** `google:JetBrains Mono`
- **Slots:** Heading, Mono
- **How:** Open the typography panel → Google Fonts tab → search "JetBrains Mono" → click Add. Assign it to the **Heading** slot and the **Mono** slot.
## Body — IBM Plex Mono
- **Source recommendation:** `google:IBM Plex Mono`
- **Slot:** Body
- **How:** Open the typography panel → Google Fonts tab → search "IBM Plex Mono" → click Add. Assign it to the **Body** slot.
## Fallback chain (already in theme CSS)
If the admin has not yet picked fonts, the theme degrades through:
```
"JetBrains Mono", "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace
```
This keeps the all-monospace aesthetic intact even without any admin font selection.
## Wave-2 follow-up
Bundling JetBrains Mono and IBM Plex Mono `.woff2` files (both OFL-licensed) is deferred to wave-2 along with the `LICENSES.md` entry. In this pass, fonts are admin-side via the Google Fonts picker.