# Iconography

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

## Purpose

One Phosphor vocabulary, applied in context, sized on the lattice, and accountable to the people who rely on it.

## Rules

### Must

- **Draw interface icons from `@phosphor-icons/react` only, to identify an action, a state or a direction.** _(Extension)_ The source brand never named a library; Phosphor is the dependency the chrome already commits to. One vocabulary keeps glyphs consistent. [Phosphor set](https://design.tetrifox.com/foundations/iconography#phosphor) · `iconography.phosphor-only`
- **Use regular weight for navigation and controls and bold for functional emphasis (links, status). Fill is reserved for labelled Play / Pause controls; thin and light only for large, quiet specimens.** Weight carries role, so it must not vary by taste. [Weight & size](https://design.tetrifox.com/foundations/iconography#weight-size) · `iconography.weights`
- **Size icons on the 4px base: `size-4` (16px) inline, `size-5` (20px) for dense dismiss controls, `size-6` (24px) for navigation targets.** Icon sizes are lattice steps like every other measure; `size-8` is reserved for feature and empty states. [Weight & size](https://design.tetrifox.com/foundations/iconography#weight-size) · `iconography.sizes`
- **Give an icon-only control an `aria-label` that names the action. When visible text already names it, or the glyph is decorative, set the icon `aria-hidden`.** _(Extension)_ Assistive technology should hear the action exactly once, never the glyph. [Usage](https://design.tetrifox.com/foundations/iconography#usage) · `iconography.accessible-name`
- **Let icons inherit colour from their context (`currentColor`) rather than carrying a colour of their own.** _(Extension)_ The icon follows the ink and state of the control it belongs to, in both themes. Tokens: `--foreground`, `--muted-foreground`, `--text-accent`. [Usage](https://design.tetrifox.com/foundations/iconography#usage) · `iconography.inherit-colour`
- **Verify every meaningful glyph against its ground at the WCAG 3:1 non-text contrast bar.** An icon that carries meaning is a user interface component; contrast is measurable. Tokens: `--background`, `--surface`. [Usage](https://design.tetrifox.com/foundations/iconography#usage) · `iconography.non-text-contrast`

### Must not

- **Use icons as decoration or identity. An icon inherits its context; it does not decorate it, and reserved glyphs stay unused until a real context ships.** _(Extension)_ Identity comes from type, the lattice and the gap. An ornamental glyph competes with them. [Phosphor set](https://design.tetrifox.com/foundations/iconography#phosphor) · `iconography.not-decoration`
- **Use the duotone weight.** _(Extension)_ Two-tone ornament is off-brand. [Weight & size](https://design.tetrifox.com/foundations/iconography#weight-size) · `iconography.no-duotone`

## Tokens used

| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--foreground` | `#f5f7fa` | `#12181f` |
| `--muted-foreground` | `#cbd2d9` | `#52606d` |
| `--text-accent` | `#ff9163` | `#a63c09` |
| `--background` | `#0a0d12` | `#ffffff` |
| `--surface` | `#1f2933` | `#f5f7fa` |

## Do / Don't

- **Naming.** Do: A search button with a `MagnifyingGlass` icon and `aria-label="Search"`. Don't: An unlabelled glyph button, or an icon announced next to text that already names it.
- **Weight.** Do: Regular in navigation, bold for a link arrow. Don't: Duotone ornaments or filled glyphs outside playback controls.

## Related chapters

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