# Earthen — fonts

Earthen **bundles** its display and body faces as `source=template` rows via
`fonts.json`, so the theme reads correctly on activation with no admin setup.
All CSS references fonts through `var(--font-heading)` / `var(--font-body)` /
`var(--font-mono)` with a fallback stack, so the admin can still override any
role from the Typography panel.

## Bundled faces (ship with the theme)

| Role | Family | Weights | File | License |
|------|--------|---------|------|---------|
| Heading | **Fraunces** | 400, 600 | `assets/fonts/fraunces-latin-400.woff2`, `fraunces-latin-600.woff2` | SIL Open Font License 1.1 (`assets/fonts/OFL.txt`) |
| Body | **Work Sans** | 400, 600 | `assets/fonts/worksans-latin-400.woff2`, `worksans-latin-600.woff2` | SIL Open Font License 1.1 (`assets/fonts/OFL.txt`) |

Fraunces gives the organic, slightly wobbly display voice the persona wants;
Work Sans keeps body copy warm but legible for donation and report pages. Both
are OFL, subset to the Latin range to stay inside the marketplace size gate.

## Fallback stacks (used before/without admin fonts)

- Heading: `var(--font-heading, "Fraunces", "Playfair Display", Georgia, serif)`
- Body: `var(--font-body, "Work Sans", ui-sans-serif, system-ui, sans-serif)`
- Mono: `var(--font-mono, "JetBrains Mono", ui-monospace, monospace)`

## Optional admin choices

- **Mono** is not bundled. If your content uses monospace (data captions, code),
  add **JetBrains Mono** (`google:JetBrains Mono`, OFL) from the Typography panel
  Google Fonts tab and assign it to Mono. Until then the system mono stack applies.
- **Alegreya** (`google:Alegreya`, OFL) is a good serif alternative for Body if you
  want a more literary, long-read feel for field journals. Assign it to Body to swap.

## Notes

- Do not hardcode a `font-family` anywhere. Every family flows through the CSS
  variables so the admin font picker keeps working.
- Bundled woff2 files are subset to Latin. Extend the subset only if you serve
  non-Latin content, and keep the total artifact within the registry size gate.