themes-kindergarten/RECOMMENDED_FONTS.md
Alex Dunmow df6ed78281 feat(kindergarten): Wave A theme lane (WO-TF-019) — 49 overrides, 7 templates, GO-BIG mascot hero
Preschool / daycare identity: crayon borders, sticker badges, confetti, and a
dependency-free bouncing-mascot + confetti-canvas hero showpiece (hero/landing
only, lazy-init, prefers-reduced-motion honored, static no-JS fallback).

- All 49 mandatory builtin overrides (OVERRIDE-CONTRACT §1), field-correct
  against the frozen cms builtins, re-skinned to the crayon design system.
  Legacy button (label/link/style) and card (text/media) field reads reconciled.
- 7 page templates: default, full-width, landing, article, blog-index, contact,
  auth — standard header/main/footer slots, dotted-paper chrome, dual-mode.
- Blocks reworked: mascot_hero/big_cta/gallery_of_art/numbers_counter/
  storybook_quote/footer converted to builtin overrides; 4 persona blocks kept/
  added — alphabet_strip (array-shaped, gotcha-safe), schedule, art_wall,
  story_time.
- 5 presets, all mode "both", bright-classroom light + quiet-time navy dark.
- Bundled OFL woff2 (Baloo 2 700, Quicksand 400/700) in assets/fonts + LICENSES;
  all font-family via var(--font-*); RECOMMENDED_FONTS/ICONS updated;
  required_icon_packs declared.
- Themed email-safe wrapper; master pages (site + auth); seed demo site
  (home/about/blog+3 posts/contact form+row_inserted email workflow/login),
  preschool voice.

Known platform limit (OVERRIDE-CONTRACT §11): auth-form/auth-status/
password-reset-form/page-suggestions overrides are authored correct-to-model but
do not dispatch (compiled BlockFuncs). page-suggestions also omits the dynamic
suggestion list (no FTS in codeless).

Verified: `make` (ninja plugin build) exit 0; check-safety exit 0. Visual quality
UNVERIFIED until Wave B.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 11:25:52 +08:00

40 lines
2.0 KiB
Markdown

# Recommended fonts — Kindergarten
This theme **bundles** two OFL (SIL Open Font License 1.1) latin-subset webfonts in
`assets/fonts/` and declares them in `fonts.json`. On install they become
`source=template` rows in the `fonts` table, so their `@font-face` declarations are
auto-emitted and they are selectable in the admin typography picker. No manual font setup
is required to get the intended look.
| Slot | Bundled family | File | Fallback stack (before assignment) |
|---|---|---|---|
| Heading (`--font-heading`) | **Baloo 2** | `fonts/baloo2-700.woff2` | `"Baloo 2", "Fredoka", "Quicksand", system-ui, sans-serif` |
| Body (`--font-body`) | **Quicksand** | `fonts/quicksand-400.woff2`, `fonts/quicksand-700.woff2` | `"Quicksand", "Nunito", system-ui, -apple-system, "Segoe UI", sans-serif` |
| Mono (`--font-mono`) | *(not bundled — system fallback)* | — | `ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace` |
## How the theme consumes them
Every `font-family` in the theme flows through a CSS variable with a bundled-family
fallback — nothing is hardcoded, so the admin picker always wins:
- `.kg-display` -> `var(--font-heading, "Baloo 2", ...)` — headlines, hero, section titles, sticker numerals.
- `.kg-body` / `.kg-prose` -> `var(--font-body, "Quicksand", ...)` — body copy, forms, cards.
- `.kg-mono` -> `var(--font-mono, ...)` — schedule times and small numeric readouts.
## To assign (optional)
Open the typography panel and assign **Baloo 2 -> Heading** and **Quicksand -> Body**. Both
appear in the picker under the theme's bundled fonts.
## Alternate direction
The locked WO-TF-019 direction pairs **Baloo 2** (rounded display) with **Quicksand**
(body). **Fredoka** (OFL) is an equally good rounded display alternative to Baloo 2 — both
are in the curated Google Fonts tab. **Nunito** (OFL) is a warmer-weight body alternative to
Quicksand.
## Licensing
Both are OFL 1.1 and cleared for redistribution inside this artifact. Details and
attribution: `assets/fonts/LICENSES.md`.