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

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

54 lines
2.1 KiB
Markdown

# Recommended Fonts — Art Deco
This theme ships `fonts.json = []` (Wave-1 policy, see `themes/docs/FONTS.md`).
The intended typographic identity is achieved by an admin assigning the
following Google Fonts to the theme's typography slots after install.
## Picker workflow
1. Sign in as an admin and open **Settings → Typography**.
2. Switch to the **Google Fonts** tab in the font picker.
3. Search for the family, click **Add**, then assign it to the listed slot.
## Display heading — Italiana
- **Source**: `google:Italiana`
- **Slot**: Heading
- **Why**: The spec calls for stamped Art Deco titles in tight tracking. Italiana
is the closest curated Google Fonts match to the high-contrast 1920s display
cuts the brief describes.
- **Fallback already in CSS**: `var(--font-heading, "Italiana", "Cinzel", Georgia, serif)`.
### Alternative
- **Source**: `google:Cinzel` (also acceptable per spec §3)
Pick this if Italiana feels too thin at small sizes.
## Body — Cormorant Garamond
- **Source**: `google:Cormorant Garamond`
- **Slot**: Body
- **Why**: Classical italic and book weights for long-form prose, exactly the
"Cormorant for long-form prose with classical italics" pairing the spec calls
out.
- **Fallback already in CSS**: `var(--font-body, "Cormorant Garamond", "Cormorant", Georgia, serif)`.
## Mono — JetBrains Mono
- **Source**: `google:JetBrains Mono`
- **Slot**: Mono
- **Why**: Spec wants a precise monospace for reservation IDs and room numbers.
JetBrains Mono ships across all curated Google Fonts and is the cleanest
utilitarian option.
- **Fallback already in CSS**: `var(--font-mono, "JetBrains Mono", ui-monospace, monospace)`.
## Notes for Wave-2
- If Italiana proves too brittle on retina at large sizes, commission a
redistributable Art Deco display face and bundle it via `fonts.json`. The
rest of the CSS is already variable-driven and will pick the new family up
without further edits.
- Body italic for the drop-cap relies on the body family having an italic
variant; both Cormorant Garamond and Cormorant ship italics in the curated
Google Fonts list — no extra picker action needed.