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

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

44 lines
2.4 KiB
Markdown

# Recommended fonts for Kindergarten
The kindergarten theme ships `fonts.json = []` per the wave-1 fonts policy
(`themes/docs/FONTS.md`). Admins assign fonts via the typography panel; this
file lists the picker recommendations sourced from the spec (`docs/works/kindergarten.md` §3).
Until the admin makes a choice, the theme falls back to its system stack:
- `--font-heading``Quicksand`, `Sniglet`, `Nunito`, system sans
- `--font-body``Nunito`, `Quicksand`, system sans
- `--font-mono``Fira Code`, `JetBrains Mono`, system monospace
## How to apply
1. Open **Settings → Typography** in the BlockNinja admin.
2. Click the **Google Fonts** tab in the font picker.
3. Add each font below using the listed picker source.
4. Assign Heading / Body / Mono in the typography panel:
- Heading slot → `google:Quicksand` (700)
- Body slot → `google:Nunito` (400, 600)
- Mono slot → `google:Fira Code` (400)
## Recommendations
| Slot | Source | Family | Weights / styles | Notes |
|---------|--------------------|-------------|---------------------|-------|
| Heading | `google:Quicksand` | Quicksand | 400, 600, 700 | Primary display face — rounded, friendly. |
| Heading (alt) | `google:Sniglet` | Sniglet | 400, 800 | Alt display face for extra-chunky banners. Confirm SIL OFL compatibility before bundling. |
| Body | `google:Nunito` | Nunito | 400, 600, 700 | Famously rounded body text. Pairs with Quicksand. |
| Mono | `google:Fira Code` | Fira Code | 400 | Use the regular weight; ligatures look great in classroom code samples. |
## Why these picks
- **Quicksand** and **Nunito** are SIL OFL — safe to recommend and free to use.
- **Sniglet** is also SIL OFL with the original "Sniglet" family available via Google Fonts as a sibling of Comfortaa. The spec calls out Sniglet as the alternate display face; ship Comfortaa as a backup if your admin prefers something with a similar feel but slightly more conservative letterforms.
- **Fira Code** is SIL OFL. The spec calls for "Fira Code Rounded" — Google Fonts ships only the regular Fira Code variants today; use the regular as the closest available stand-in.
## Wave-2 follow-up
If the brand requires Sniglet rounded everywhere, bundle the woff2 files
inside `assets/fonts/web/` and add the entries to `fonts.json` per the
schema in `themes/docs/FONTS.md`. Record the licence in `LICENSES.md` at the
theme root.