# Recommended Fonts — Brutalist

`fonts.json` ships empty (`[]`) per the wave-1 policy in
`/home/alex/src/blockninja/themes/docs/FONTS.md`. No woff2 files are bundled in
this build pass; the theme uses CSS variable fallback stacks until an admin
assigns fonts in the typography panel.

All three roles below are available in the Google Fonts tab of the typography
picker. Open the typography panel, pick from the **Google Fonts** tab, and
assign:

| Role | Source | Family | Notes |
|---|---|---|---|
| Heading | `google:Space Grotesk` | Space Grotesk | Display / wordmark face. The whole point of the theme is that it lives at 200pt+. Bold (700) is what the templates default to. |
| Body | `google:Inter` | Inter | 16–18px body copy with generous tracking. Weights 400 and 600. (Inter Tight is an acceptable swap if you prefer tighter setting.) |
| Mono | `google:JetBrains Mono` | JetBrains Mono | 11px mono captions, figure numbers, timestamps, metadata. Weights 400 and 700. |

## CSS fallback chain (already in the theme)

Until those assignments land, every `font-family` declaration in the theme
flows through CSS custom properties with the following fallback stacks:

```css
var(--font-heading, "Space Grotesk", "Inter Tight", "Helvetica Neue", Helvetica, Arial, sans-serif)
var(--font-body, "Inter", "Inter Tight", -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif)
var(--font-mono, "JetBrains Mono", "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace)
```

## Wave-2 follow-up (out of scope)

The wider design system roadmap calls for shipping a custom display face for
Brutalist. When that lands, replace this doc with a `LICENSES.md` and add the
woff2 family to `fonts.json` per the schema in `docs/FONTS.md`.