# Typography

> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/typography

## Purpose

Two faces. Sixteen sizes. One voice. Type is assembled with the same discipline as a Mino: every role is explicit, every choice earns its place.

## Rules

### Must

- **Set display, body and labels in Satoshi through `--font-sans`, loaded locally.** One workhorse face keeps every role in the same voice; local loading with a metric-adjusted fallback avoids layout shift. Tokens: `--font-sans`. [Satoshi](https://design.tetrifox.com/foundations/typography#satoshi) · `typography.satoshi-workhorse`
- **Use Futura only through the three `accent-*` classes, at weight 500.** Futura is the companion, not a substitute. Bounded to three classes, it stays an accent. Tokens: `--font-accent`, `accent-lg`, `accent-md`, `accent-sm`. [Satoshi](https://design.tetrifox.com/foundations/typography#satoshi) · `typography.futura-accent-only`
- **Use the sixteen shipped classes — seven display, five body, one label, three accent — and optionally a `weight-*` modifier. Do not add a size or set font sizes ad hoc.** A closed scale is what makes the type a system. Display sizes carry their own mobile overrides below 768px; body, label and accent sizes are constant. Tokens: `display-hero`, `display-2xl`, `display-xl`, `display-lg`, `display-md`, `display-sm`, `display-xs`, `body-xl`, `body-lg`, `body-md`, `body-sm`, `body-xs`, `weight-light`, `weight-regular`, `weight-medium`, `weight-bold`, `weight-black`. [Type scale](https://design.tetrifox.com/foundations/typography#type-scale) · `typography.closed-scale`
- **Use one `<h1>` per page and never skip a heading level. The size class is independent of the tag: a `display-md` heading can be an `<h2>`.** Heading order is document structure for assistive technology and machines; the visual scale is a separate decision. Tokens: `display-md`. [Type scale](https://design.tetrifox.com/foundations/typography#type-scale) · `typography.one-h1`
- **Write headings in sentence case unless a proper noun requires otherwise.** Sentence case reads as plain statement, not as a slogan. [Type scale](https://design.tetrifox.com/foundations/typography#type-scale) · `typography.sentence-case`
- **Label a section with `label-sm text-accent` before its heading. Write the source text in sentence case; the class supplies uppercase, tracking and weight.** The eyebrow pairing is a signature of the brand, and the casing belongs to the style, not the copy. Tokens: `label-sm`, `--text-accent`. [The eyebrow](https://design.tetrifox.com/foundations/typography#the-eyebrow) · `typography.eyebrow`

### Must not

- **Turn explanatory copy orange to make it look like an eyebrow.** Orange identifies the label. A sentence in the accent is still body copy, and it spends the one signal colour. Tokens: `--text-accent`. [The eyebrow](https://design.tetrifox.com/foundations/typography#the-eyebrow) · `typography.eyebrow-not-copy`

### Prefer

- **Italicise at most one word in a headline — the word that carries the tension — with a semantic `<em>`.** _(Extension)_ In the source headline, “outpacing” names the gap the sentence is built around. Move or multiply the italic and the line stops meaning anything. [Emphasis](https://design.tetrifox.com/foundations/typography#the-emphasis) · `typography.one-tension-word`
- **End a statement headline with a full stop. Genuine questions keep their question mark; deliberate fragments can stay direct.** _(Extension)_ The period lets a line settle without turning punctuation into decoration. [The period](https://design.tetrifox.com/foundations/typography#the-period) · `typography.period`
- **Set numbers, tokens, timings, versions and metadata in the system monospace stack (`font-mono`). Prose is never monospace.** _(Extension)_ Mono marks the machine register. No mono webfont is shipped; adding one for a handful of labels would be an extension, not a recommendation. [Monospace](https://design.tetrifox.com/foundations/typography#monospace) · `typography.monospace`

## Tokens used

| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--text-accent` | `#ff9163` | `#a63c09` |

| Class | Font | Weight | Desktop (size / line) | Mobile (size / line) |
| --- | --- | --- | --- | --- |
| `accent-lg` | Futura | 500 | 1.5rem / 2rem | 1.5rem / 2rem |
| `accent-md` | Futura | 500 | 1.25rem / 1.875rem | 1.25rem / 1.875rem |
| `accent-sm` | Futura | 500 | 1.125rem / 1.75rem | 1.125rem / 1.75rem |
| `display-hero` | Satoshi | 400 | 7.5rem / 1 | 3rem / 1 |
| `display-2xl` | Satoshi | 400 | 4.5rem / 5rem | 2.25rem / 2.75rem |
| `display-xl` | Satoshi | 400 | 3.5rem / 4.5rem | 2rem / 2.5rem |
| `display-lg` | Satoshi | 400 | 3rem / 3.75rem | 1.75rem / 2.25rem |
| `display-md` | Satoshi | 400 | 2.5rem / 3rem | 1.5rem / 2rem |
| `display-sm` | Satoshi | 400 | 2rem / 2.375rem | 1.375rem / 1.75rem |
| `display-xs` | Satoshi | 400 | 1.5rem / 2rem | 1.25rem / 1.75rem |
| `body-xl` | Satoshi | 400 | 1.25rem / 1.875rem | 1.25rem / 1.875rem |
| `body-lg` | Satoshi | 400 | 1.125rem / 1.75rem | 1.125rem / 1.75rem |
| `body-md` | Satoshi | 400 | 1rem / 1.5rem | 1rem / 1.5rem |
| `body-sm` | Satoshi | 400 | 0.875rem / 1.25rem | 0.875rem / 1.25rem |
| `body-xs` | Satoshi | 400 | 0.75rem / 1.125rem | 0.75rem / 1.125rem |
| `label-sm` | Satoshi | 500 | 0.875rem / 1.25rem | 0.875rem / 1.25rem |

| Token | Value | Source |
| --- | --- | --- |
| `--font-sans` | `Satoshi (var(--font-satoshi))` | src/styles/colors.css |
| `--font-accent` | `Futura (var(--font-futura))` | src/styles/colors.css |
| `weight-light` | `font-weight: 300` | src/styles/typography.css |
| `weight-regular` | `font-weight: 400` | src/styles/typography.css |
| `weight-medium` | `font-weight: 500` | src/styles/typography.css |
| `weight-bold` | `font-weight: 700` | src/styles/typography.css |
| `weight-black` | `font-weight: 900` | src/styles/typography.css |

## Do / Don't

- **Emphasis.** Do: Your product is *outpacing* your engineering. Don't: *Your* product is outpacing *your* engineering.
- **Eyebrow.** Do: A short `label-sm text-accent` label above the heading. Don't: An explanatory sentence set in orange body text.

## Related chapters

- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Voice & tone](https://design.tetrifox.com/foundations/voice.md)
- [Components](https://design.tetrifox.com/expressions/components.md)
