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

1.5 KiB

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.