# Components

> Expressions · Tetrifox Brand Book · https://design.tetrifox.com/expressions/components

## Purpose

A component is a brand decision made reusable: one implementation carries its hierarchy, states, semantics, and motion constraints across every page that uses it.

## Rules

### Must

- **Reuse `Button`, `Card`, `SectionHeader` and the `Reveal` family before creating a component. New components are designed for three pages, not one.** A component is a brand decision made reusable; a one-off hack forks the decision. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.reuse`
- **Use the three button variants only: `primary` (solid orange pill) and `secondary` (bordered pill that never fills with a surface colour), both labelled `body-sm weight-medium`; and `link` (`accent-sm` accent text with an arrow).** Variant carries priority. A component does not become primary because it sits first. Tokens: `--color-brand-700`, `--border-strong`, `body-sm`, `weight-medium`, `accent-sm`. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.button-variants`
- **Lead each view with at most one primary button; use secondary and link buttons for everything else.** One view, one priority. Tokens: `--color-brand-700`. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.one-primary`
- **Links navigate; buttons perform an action. Use `next/link` for internal routes, and give external links `target="_blank"` with `rel="noopener noreferrer"`.** The element is what assistive technology announces; the variant is only how it looks. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.button-semantics`
- **Share one visible focus outline across variants (`outline-2 outline-offset-2 outline-brand-600`). Disabled buttons use the native `disabled` attribute, keep their shape at 50% opacity, and lose hover and active movement.** State must read the same on every action; reduced motion keeps colour and removes lift and arrow travel. Tokens: `--color-brand-600`. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.button-states`
- **Shape every section as `Section` > `Cell` > `SectionHeader` > content > optional call to action.** A predictable shape gives each section a subject, a claim and enough context to understand what follows. [Section headers](https://design.tetrifox.com/expressions/components#section-headers) · `components.section-shape`
- **Open with `SectionHeader`: an eyebrow (`label-sm text-accent`), a real `h1`–`h3` whose level is independent of its size, and a `body-lg` subtitle on a capped measure. Pass `anchorId` so the heading owns the deep link.** Navigation, the sticky-header offset and assistive technology share one target. Tokens: `label-sm`, `body-lg`, `--text-accent`. [Section headers](https://design.tetrifox.com/expressions/components#section-headers) · `components.section-header`
- **Use semantic elements — `nav`, `main`, `section`, `article`, `aside`, `header`, `footer` — and a skip link on every page. Never `div` soup.** Structure is what assistive technology and machines read. [Section headers](https://design.tetrifox.com/expressions/components#section-headers) · `components.semantic-html`
- **Render images with `next/image`, never a raw `<img>`, with explicit dimensions or `fill` in a sized parent. Meaningful images carry real `alt` text; decorative ones use `alt=""` and `aria-hidden`.** Sized images never shift the layout, and only meaningful images speak. [Section headers](https://design.tetrifox.com/expressions/components#section-headers) · `components.images`
- **Wrap entrances in `Reveal`, `RevealStagger` / `RevealItem`, or — above the fold — `HeroReveal` / `HeroStagger`. Do not hand-wire `motion.div` in sections.** The wrappers fire once with the shared presets and render settled under reduced motion. Tokens: `transitions.reveal`, `variants.fadeUp`, `variants.gridStagger`. [Reveals](https://design.tetrifox.com/expressions/components#reveals) · `components.reveal-wrappers`
- **Use CSS transitions (about 200ms) for hover, never Motion components, and honour `html[data-motion]` as well as `motion-reduce`.** An in-app reduced-motion override must remove lift, arrow travel and gap changes too. Tokens: `durations.fast`. [Reveals](https://design.tetrifox.com/expressions/components#reveals) · `components.css-hover`

### Must not

- **Hand-style an arrow next to text. Use `<Button variant="link">`.** The link variant owns the arrow, its gap and its reduced-motion behaviour. [Buttons](https://design.tetrifox.com/expressions/components#buttons) · `components.no-hand-styled-arrows`
- **Give a card its own outer border, lift it without a real interaction, or hand-style its actions.** _(Extension)_ The surrounding matrix owns the frame; actions inside a card reuse `Button`. [Cards](https://design.tetrifox.com/expressions/components#cards) · `components.card-frame`

### Prefer

- **Use `Card` as a composable content cell on the `surface` token with the canonical Cell inset, not as a rigid title-and-description schema.** _(Extension)_ The live source repeats service, process and metric shapes but defines no shared card; the primitive is derived from those shapes. Tokens: `--surface`. [Cards](https://design.tetrifox.com/expressions/components#cards) · `components.card-extension`

## Tokens used

| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--color-brand-700` | `#c94a0a` | `#c94a0a` |
| `--border-strong` | `#9aa5b1` | `#52606d` |
| `--color-brand-600` | `#ea580c` | `#ea580c` |
| `--surface` | `#1f2933` | `#f5f7fa` |
| `--text-accent` | `#ff9163` | `#a63c09` |

| Class | Font | Weight | Desktop (size / line) | Mobile (size / line) |
| --- | --- | --- | --- | --- |
| `body-sm` | Satoshi | 400 | 0.875rem / 1.25rem | 0.875rem / 1.25rem |
| `accent-sm` | Futura | 500 | 1.125rem / 1.75rem | 1.125rem / 1.75rem |
| `label-sm` | Satoshi | 500 | 0.875rem / 1.25rem | 0.875rem / 1.25rem |
| `body-lg` | Satoshi | 400 | 1.125rem / 1.75rem | 1.125rem / 1.75rem |

| Token | Value | Source |
| --- | --- | --- |
| `weight-medium` | `font-weight: 500` | src/styles/typography.css |
| `transitions.reveal` | `{"duration":0.8,"ease":[0,0,0.2,1]}` | src/lib/motion.ts |
| `variants.fadeUp` | `{"hidden":{"opacity":0,"y":24},"visible":{"opacity":1,"y":0}}` | src/lib/motion.ts |
| `variants.gridStagger` | `{"hidden":{},"visible":{"transition":{"staggerChildren":0.08}}}` | src/lib/motion.ts |
| `durations.fast` | `0.2` | src/lib/motion.ts |

## Do / Don't

- **Priority.** Do: One primary “Talk to a founder”, a secondary “See how a Mino works”, a link “Explore Minos”. Don't: Two orange pills side by side.
- **Arrow links.** Do: `<Button variant="link" href="/expressions/minos">Explore Minos</Button>` Don't: A text link followed by a hand-placed arrow icon.

## Related chapters

- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Motion](https://design.tetrifox.com/foundations/motion.md)
- [Layout & grid](https://design.tetrifox.com/foundations/layout.md)
