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

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

46 lines
1.8 KiB
Markdown

# Recommended fonts — Pastel Dream
This pass ships `fonts.json = []` per the wave-1 fonts policy (see
`themes/docs/FONTS.md`). The visual identity is realised through CSS variable
fallback stacks (`--font-heading`, `--font-body`, `--font-mono`) so the theme
renders sensibly out of the box.
To match the intended Pastel Dream aesthetic, an admin should open the
typography panel and add the fonts below from the Google Fonts tab, then
assign each to its slot. All three are in the curated Google Fonts list and
require no upload.
## Display / hand-lettered (assign to Heading)
- `google:Caveat Brush` — primary display face for H1 and H2. Hand-lettered,
warm, and rounded. Picks up beautifully behind the brush-stroke underline.
- Alternates (pick one): `google:Sacramento`, `google:Homemade Apple`.
## Body (assign to Body)
- `google:Nunito` — softened sans, ships with weights 300, 400, 600, 700.
Used at line-height 1.75 per the spec.
- Alternate: `google:Quicksand` for an even softer, more rounded body.
## Mono / numerals (assign to Mono)
- `google:JetBrains Mono` — used for eyebrow labels, small caps tracking, and
date strings.
- Alternate: `google:Fira Code`.
## How to assign
1. Open `/admin/system/typography` (or your instance's typography panel).
2. Open the Google Fonts tab.
3. Search for each family above and click "Add".
4. In the Heading / Body / Mono slots, pick the family you added.
5. Save. The CMS injects an `@import` link and re-renders.
## Why no bundled woff2 in this pass
Wave-1 implementation policy ships every theme with `fonts.json = []` and
relies on the CSS variable consumer pattern. A future wave will bundle
distinctive commercial display faces (or self-host the OFL fonts above) for
themes where the typographic identity is core. See
`themes/docs/FONTS.md` for the full rationale.