023bd23d96
WO-TF-013. Bring the coffee theme up to the frozen OVERRIDE-CONTRACT: - 49 mandatory builtin overrides in templates/overrides/coffee/ (chrome, marketing, primitives, commerce/local, blog family, auth surface, page-suggestions), each re-skinned in cafe/roastery chrome over the builtin data model. Legacy button/heading/image/text field reads updated to the new builtin contract (link/label/style, media/text). - Signature moves: chalkboard menu panel (menu-list), hand-drawn doodle dividers, torn-paper edges, kraft-tag stamped buttons, circular roast stamps, hours "today" highlight. Semantic tokens only; CSS-first motion with prefers-reduced-motion fallbacks. - 7 page templates: default, landing, article, full-width, blog-index, contact, auth. - Blocks rework: deleted the five builtin-duplicating theme blocks (menu_board, hours_strip, location_card, footer, doodle_divider) — now overrides. Kept/added 4 persona blocks: featured_pour, roast_profile, loyalty_card, brew_guide. - 5 dual-mode presets (mode "both"), all 19 tokens, light and dark tuned. - Bundled Fraunces / Work Sans / Caveat woff2 (OFL, latin subset, license recorded); fonts.json populated; all font-family via var(--font-*). Updated RECOMMENDED_FONTS.md, added RECOMMENDED_ICONS.md; required_icon_packs declared. - Themed email-safe wrapper retained (tables, inline styles). - Master pages rebuilt on builtin keys. Demo seed (demo:true): home, about, blog + 3 posts, contact (form + contact_submissions data table + row_inserted email-admins workflow), login. Cafe voice. make (codeless build + verify) and check-safety both exit 0. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# Coffee — Recommended fonts
|
|
|
|
The Coffee theme **bundles** its type as woff2 in `assets/fonts/` (latin
|
|
subsets, SIL Open Font License 1.1 — see `assets/fonts/OFL.txt`). The three
|
|
families become `source=template` rows in the fonts table and are selectable
|
|
in the admin typography picker. Templates always resolve font families through
|
|
the BlockNinja CSS variables `--font-heading`, `--font-body`, `--font-mono`
|
|
with the fallback stacks defined in the theme CSS — no family is hardcoded.
|
|
|
|
## Bundled families
|
|
|
|
| Slot | Family | Weights | Role |
|
|
|-----------|------------|-----------|------|
|
|
| Heading | Fraunces | 400, 600 | Ligature-rich display serif for headings and prices. Warm, hand-cut character. |
|
|
| Body | Work Sans | 400, 600 | Relaxed grotesque for long copy at 17px+. Reads well on cream and espresso backgrounds. |
|
|
| Accent | Caveat | 400, 700 | Hand-drawn script for badges, stamps, and doodle captions. |
|
|
|
|
Mono is intentionally **not** bundled: prices and tabular figures fall back to
|
|
`"JetBrains Mono", ..., monospace` via `--font-mono`. Assign a mono family from
|
|
the Google Fonts tab if you want a specific face.
|
|
|
|
## Default behaviour (no admin picks)
|
|
|
|
On a fresh install the admin has not assigned any slot, so `--font-heading` /
|
|
`--font-body` / `--font-mono` are unset and the CSS fallbacks apply. Because the
|
|
bundled families emit `@font-face` from the fonts table, the fallbacks resolve
|
|
to the bundled woff2:
|
|
|
|
- Headings render in **Fraunces**.
|
|
- Body renders in **Work Sans**.
|
|
- Hand-drawn accents (`.coffee-hand`) render in **Caveat**.
|
|
|
|
## How to change
|
|
|
|
1. Open admin → Theme → Typography.
|
|
2. Pick a family per slot (bundled families appear as **Template** fonts; the
|
|
Google Fonts tab offers ~50 more).
|
|
3. Assign to Heading / Body / Mono and save.
|
|
|
|
Note: the platform exposes three controllable slots. The hand-drawn accent
|
|
utility resolves through `--font-heading` (falling back to Caveat), so if you
|
|
deliberately change the heading font the badge accents follow it — that is the
|
|
three-slot model working as intended.
|
|
|
|
## Fallback stacks (theme CSS)
|
|
|
|
- `--coffee-heading-fallback`: `"Fraunces", "Playfair Display", Georgia, "Times New Roman", serif`
|
|
- `--coffee-body-fallback`: `"Work Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif`
|
|
- `--coffee-hand-fallback`: `"Caveat", "Segoe Print", "Bradley Hand", cursive`
|
|
- `--coffee-mono-fallback`: `"JetBrains Mono", "Fira Code", Menlo, Consolas, monospace`
|