# Tetrifox Brand Book (full text)
> Tetrifox is a product engineering partner that builds modular software development teams — called Minos — for startups and scale-ups that need to move from idea to production fast.
Version: 0.1.0 (book v0.1) · Generated: 2026-10-20 · Tokens: https://design.tetrifox.com/tokens.json
## Logo
> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/logo
### Purpose
The logo is the least load-bearing part of this system. Type, lattice, gap, and restrained colour carry Tetrifox — so the supplied mark can stay quiet and disciplined.
### Rules
#### Must
- **Use one of the three supplied forms — complete lockup, wordmark, mark — and choose the least reduced form the space can hold.** The complete lockup establishes mark and name together; reduce only when the space forces it. [The logo](https://design.tetrifox.com/foundations/logo#the-logo) · `logo.supplied-family`
- **Place the wordmark top-left in the header at 32px tall, linking home.** This is the live placement in product. [Placement](https://design.tetrifox.com/foundations/logo#placement) · `logo.header`
#### Must not
- **Rebuild, redraw or recolour the logo. Download the approved master: white for dark surfaces, black for light surfaces.** The masters in the logo kit are the only approved renderings; a rebuilt mark drifts. [The logo](https://design.tetrifox.com/foundations/logo#the-logo) · `logo.use-the-master`
- **Assign the mark a story its construction does not show. Describe what is there: two interlocking forms, one filled and one outlined, sharing angles around a central negative space.** The supplied construction asset is the evidence; anything beyond it would be an invented brand fact. [The story](https://design.tetrifox.com/foundations/logo#the-story) · `logo.construction`
- **Alter the colour, distort, rotate, add effects (glows, bevels, shadows), box the logo in a decorative container, or crowd it with type.** _(Extension)_ Each protects the supplied asset without inventing a new colour standard. [Incorrect usage](https://design.tetrifox.com/foundations/logo#incorrect-usage) · `logo.no-alteration`
#### Prefer
- **Let the system carry recognition: a Tetrifox surface should still read as Tetrifox with the logo cropped out.** Type, the closed lattice, the gap and restrained orange do the identifying, which is what lets the mark stay quiet. [The logo](https://design.tetrifox.com/foundations/logo#the-logo) · `logo.crop-test`
- **Keep a clear field of at least 1× the cap height around the visible edge of the asset. Type, metadata and frame edges stop at its boundary.** _(Extension)_ Proposed, not yet approved: no external specification for clearspace exists in the source material. [Clearspace](https://design.tetrifox.com/foundations/logo#clearspace) · `logo.clearspace`
- **When the wordmark stops reading, switch to the mark instead of shrinking further. Change the asset, never its proportions.** _(Extension)_ Only the 32px header use is verified. 20px is a stress test, not an approved minimum; the book sets no minimum size. [Sizing](https://design.tetrifox.com/foundations/logo#sizing) · `logo.change-form`
- **In wide, square or portrait frames, start the lockup from the same protected top-left inset.** _(Extension)_ A consistent origin makes placement a system rather than a per-format decision. [Placement](https://design.tetrifox.com/foundations/logo#placement) · `logo.same-origin`
### Tokens used
This chapter's rules reference no tokens.
### Do / Don't
- **Form.** Do: The complete lockup when the space allows; the mark when the name no longer reads. Don't: A wordmark shrunk until it is illegible.
- **Finish.** Do: The supplied white master on the dark field, left alone. Don't: A recoloured, shadowed or boxed logo.
### Related chapters
- [Layout & grid](https://design.tetrifox.com/foundations/layout.md)
- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Templates](https://design.tetrifox.com/expressions/templates.md)
---
## Colour
> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/colour
### Purpose
Disciplined raw material becomes meaning through semantic tokens. Dark-first, accessible, and precise enough that orange signals without becoming the field.
### Rules
#### Must
- **Design dark-first. `:root` is the canonical dark field; `.light` is an opt-in inverse applied as a class on ``.** The brand is built on a dark field. Light is proof that the tokens invert cleanly, not a second identity. Tokens: `--background`, `--foreground`. [Dark-first palette](https://design.tetrifox.com/foundations/colour#palette) · `colour.dark-first`
- **Reach for a semantic token first. Use a raw ramp step only when no semantic role fits.** Semantic tokens follow the active theme and carry intent; a ramp step is fixed raw material. [Ramps](https://design.tetrifox.com/foundations/colour#ramps) · `colour.semantic-first`
- **Use the fixed, theme-independent status colours for error, success and warning. The green ramp is brand-positive, not a status colour.** Status must read the same in both themes; brand green stays a ramp used sparingly. Tokens: `--color-error`, `--color-success`, `--color-warning`. [Ramps](https://design.tetrifox.com/foundations/colour#ramps) · `colour.status-colours`
- **Bind every interface colour to a semantic role — field, ink, layer, divider, state or signal — so it follows the active theme.** Roles are what invert between themes; the role name also tells the next reader why the colour is there. Tokens: `--background`, `--foreground`, `--surface`, `--border`, `--muted`, `--text-accent`. [Semantic tokens](https://design.tetrifox.com/foundations/colour#semantic-tokens) · `colour.bind-to-role`
- **Reserve orange for actions, focus, labels (the eyebrow) and text selection.** Orange is the signal; each use points at something. Tokens: `--text-accent`, `--color-brand-600`, `--color-brand-500`. [Accent restraint](https://design.tetrifox.com/foundations/colour#accent-restraint) · `colour.accent-uses`
- **Show one primary (orange) button per view; use secondary or link buttons for every other action.** Two orange actions cancel each other out. Tokens: `--color-brand-700`. [Accent restraint](https://design.tetrifox.com/foundations/colour#accent-restraint) · `colour.one-primary-action`
- **Text must clear WCAG AA against its ground: 4.5:1 for body text, 3:1 for large text (24px and up, or 18.66px bold).** Contrast is a measurable consequence of every colour choice. Tokens: `--foreground`, `--muted-foreground`, `--background`. [Contrast (AA)](https://design.tetrifox.com/foundations/colour#contrast) · `colour.text-aa`
- **Verify contrast in both themes. Each theme carries its own accent step, so a verdict in dark says nothing about light.** `--text-accent` resolves to a lighter step on the dark field and a darker step on white. Tokens: `--text-accent`. [Contrast (AA)](https://design.tetrifox.com/foundations/colour#contrast) · `colour.measure-per-theme`
#### Must not
- **Hardcode hex values in components, or introduce colours outside the four ramps and the fixed status colours.** A literal cannot follow the theme or be traced back to a decision. [Ramps](https://design.tetrifox.com/foundations/colour#ramps) · `colour.no-hardcoded-hex`
- **Use brand orange as a field, a large fill, or body copy.** A flooded surface leaves nothing to point at, and white body text on `--color-brand-600` does not clear AA. Tokens: `--color-brand-600`. [Accent restraint](https://design.tetrifox.com/foundations/colour#accent-restraint) · `colour.accent-not-field`
#### Prefer
- **Separate layers with semantic surfaces and borders before reaching for another hue.** _(Extension)_ Depth comes from the surface ladder; a new hue competes with the one accent that is allowed to signal. Tokens: `--surface`, `--surface-alt`, `--border`. [Dark-first palette](https://design.tetrifox.com/foundations/colour#palette) · `colour.depth-before-colour`
- **Use cyan sparingly, as a secondary signal. Its documented anchor is the motion bloom of the pattern background.** Cyan is the counterpoint to orange, not a second accent. Tokens: `--color-cyan-400`, `--field-bloom`. [Ramps](https://design.tetrifox.com/foundations/colour#ramps) · `colour.cyan-signal`
- **In Tailwind, use the aliased utilities — `bg-background`, `bg-surface`, `text-primary`, `text-secondary`, `text-tertiary`, `text-accent`, `border-border` — rather than ramp utilities.** The aliases resolve to the semantic layer through `@theme inline`, so components stay theme-aware without extra classes. Tokens: `--color-primary`, `--color-secondary`, `--color-tertiary`, `--color-accent`. [Semantic tokens](https://design.tetrifox.com/foundations/colour#semantic-tokens) · `colour.tailwind-aliases`
- **Judge accent restraint by role — one action, labels, focus — not by a coverage percentage. The book sets no numeric budget for orange.** _(Extension)_ A percentage would be an invented fact; the Images grade reports warm coverage as evidence, never as pass or fail. [Accent restraint](https://design.tetrifox.com/foundations/colour#accent-restraint) · `colour.no-accent-budget`
- **Keep accent text to short labels and links. Prose stays on the foreground and secondary inks.** _(Extension)_ The accent passes AA in both themes, so this is restraint, not contrast: a paragraph of orange stops signalling. Tokens: `--text-accent`, `--foreground`, `--muted-foreground`. [Incorrect usage](https://design.tetrifox.com/foundations/colour#incorrect-usage) · `colour.accent-short-labels`
### Tokens used
| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--background` | `#0a0d12` | `#ffffff` |
| `--foreground` | `#f5f7fa` | `#12181f` |
| `--surface` | `#1f2933` | `#f5f7fa` |
| `--surface-alt` | `#323f4b` | `#e4e7eb` |
| `--border` | `#1f2933` | `#cbd2d9` |
| `--color-error` | `#dc2626` | `#dc2626` |
| `--color-success` | `#16a34a` | `#16a34a` |
| `--color-warning` | `#d97706` | `#d97706` |
| `--color-cyan-400` | `#2bc4f0` | `#2bc4f0` |
| `--field-bloom` | `#2bc4f0` | `#10add9` |
| `--muted` | `#a0abb7` | `#616e7c` |
| `--text-accent` | `#ff9163` | `#a63c09` |
| `--color-primary` | `#f5f7fa` | `#12181f` |
| `--color-secondary` | `#cbd2d9` | `#52606d` |
| `--color-tertiary` | `#a0abb7` | `#616e7c` |
| `--color-accent` | `#ff9163` | `#a63c09` |
| `--color-brand-600` | `#ea580c` | `#ea580c` |
| `--color-brand-500` | `#f97316` | `#f97316` |
| `--color-brand-700` | `#c94a0a` | `#c94a0a` |
| `--muted-foreground` | `#cbd2d9` | `#52606d` |
### Do / Don't
- **Signal, not surface.** Do: The field stays neutral; orange marks one deliberate action. Don't: The accent becomes the environment and body contrast collapses.
- **Meaning, not a literal.** Do: The semantic alias keeps the component tied to its role. Don't: A raw value cannot follow the active theme or communicate intent.
- **Readable, not merely branded.** Do: Foreground carries prose; accent remains a short label. Don't: Brand orange as body copy on white reaches AA-large at best.
### Related chapters
- [Typography](https://design.tetrifox.com/foundations/typography.md)
- [Iconography](https://design.tetrifox.com/foundations/iconography.md)
- [Components](https://design.tetrifox.com/expressions/components.md)
---
## 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 `
` per page and never skip a heading level. The size class is independent of the tag: a `display-md` heading can be an `
`.** 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 ``.** _(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)
---
## Layout & grid
> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/layout
### Purpose
Every Tetrifox screen begins with the same constraints: close the frame, quantize the space, assemble from cells. Layout is not decoration around content — it is the system the interface grows from.
### Rules
#### Must
- **Close every edge. Each line meets a neighbour or the frame; build divided layouts from `Section`, `Cell` and `GridRow`, not ad-hoc `grid gap-*` or flexbox.** The closed lattice is the modular-assembly thesis made structural. An open edge or a floating border never resolves. [The closed grid](https://design.tetrifox.com/foundations/layout#closed-grid) · `layout.closed-grid`
- **Keep borders structural: 1px hairlines in `--border` or `--border-subtle`.** Borders are the grid lines of the system, not decoration. Tokens: `--border`, `--border-subtle`. [The closed grid](https://design.tetrifox.com/foundations/layout#closed-grid) · `layout.hairlines`
- **Use only the nine lattice steps — Tailwind `1, 2, 3, 4, 6, 8, 12, 16, 24` (4 to 96px) — for padding, margin and gaps.** A 4px base and an 8px rhythm keep every measure on the same beat. [Spacing lattice](https://design.tetrifox.com/foundations/layout#spacing-lattice) · `layout.lattice-steps`
- **Align primary text, captions, labels, tables, controls, Header and Footer to the content rail `px-6 md:px-8 lg:px-12` (24 → 32 → 48px). The compact navigation Rail is the one exception.** One inset per breakpoint lines every region up on the same vertical. [Spacing lattice](https://design.tetrifox.com/foundations/layout#spacing-lattice) · `layout.content-rail`
- **Use `Cell padding="standard"` or `padding="section"` and do not add competing `p-*` or `px-*` classes to a padded Cell. `padding="none"` is for full-bleed visuals.** The modes carry the rail and the vertical rhythm: `standard` is `px-6 py-4 md:px-8 md:py-6 lg:px-12 lg:py-8`, `section` is `px-6 py-16 md:px-8 md:py-24 lg:px-12`. `cn` joins class strings without resolving Tailwind conflicts, so a second padding class silently competes. [Spacing lattice](https://design.tetrifox.com/foundations/layout#spacing-lattice) · `layout.cell-padding`
- **Let the viewport be the frame: no outer gutters and no centred `max-w-* mx-auto` column around the interface.** Outer gutters let borders float away from the frame. Sections are full-bleed bands whose borders close against the viewport. [Frame & containers](https://design.tetrifox.com/foundations/layout#frame-containers) · `layout.full-bleed`
- **Cap reading measures inside content (`max-w-md`, `max-w-xl`, `max-w-3xl`) for readability on wide screens.** Readability comes from the line length of the text, not from boxing the whole page. [Frame & containers](https://design.tetrifox.com/foundations/layout#frame-containers) · `layout.capped-measure`
- **Pin the Rail (`w-64`, `border-r`) to the left edge, span a sticky Header (`border-b`) and a Footer (`border-t`) full width, and let `` fill the rest. No border above the header or below the footer.** The shell's internal borders, with each Section's `border-b`, close every cell against the viewport. [Frame & containers](https://design.tetrifox.com/foundations/layout#frame-containers) · `layout.shell`
- **Assemble from three primitives: `Section` (a full-bleed band with a bottom hairline), `Cell` (padding, no borders) and `GridRow` (one divider that stacks as `border-t` and becomes `border-l` in a row).** A small vocabulary recomposes across viewports without visual drift. [Cellular primitives](https://design.tetrifox.com/foundations/layout#cellular-primitives) · `layout.primitives`
- **Draw status markers as squares, never circles: hollow for gap, muted fill for draft, brand fill for shipped.** The mark echoes the cell and gap shape the whole brand is built on. [Cellular primitives](https://design.tetrifox.com/foundations/layout#cellular-primitives) · `layout.square-status`
#### Must not
- **Add a second outer `border border-border` to a specimen inside an already-framed region. Continue the matrix with `gap-px bg-border`, or separate parts with only the `border-t` / `border-l` they need.** One region, one frame. `Section`, `GridRow`, the shell and section-level matrices own the structural borders; doubled hairlines break the lattice. Tokens: `--border`. [The closed grid](https://design.tetrifox.com/foundations/layout#closed-grid) · `layout.one-frame-owner`
- **Use the `.5` half-steps: `p-1.5` (6px), `gap-2.5` (10px), `py-3.5` (14px).** Half-steps break the rhythm and are not part of the system. [Spacing lattice](https://design.tetrifox.com/foundations/layout#spacing-lattice) · `layout.no-half-steps`
#### Prefer
- **Reserve self-contained micro-frames for small teaching diagrams whose border is the lesson: Layout specimens, Logo clearspace and incorrect-use examples, compact Mino diagrams.** These are the documented exceptions to one-frame-owner; anything else continues the lattice. [The closed grid](https://design.tetrifox.com/foundations/layout#closed-grid) · `layout.micro-frames`
- **Use `gap-2` between stacked items, `gap-8` between groups, and `py-16 md:py-24` for section rhythm.** Three named rhythms cover almost every vertical decision. [Spacing lattice](https://design.tetrifox.com/foundations/layout#spacing-lattice) · `layout.rhythm`
### Tokens used
| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--border` | `#1f2933` | `#cbd2d9` |
| `--border-subtle` | `#323f4b` | `#e4e7eb` |
### Do / Don't
- **Frame.** Do: Full-bleed bands; the paragraph inside carries `max-w-xl`. Don't: A `max-w-7xl mx-auto` container whose border floats in the gutter.
- **Spacing.** Do: `gap-2`, `px-6 md:px-8 lg:px-12`, `py-16 md:py-24`. Don't: `p-1.5`, `gap-2.5`, `py-3.5`.
### Related chapters
- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Components](https://design.tetrifox.com/expressions/components.md)
- [Minos & configurations](https://design.tetrifox.com/expressions/minos.md)
---
## Motion
> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/motion
### Purpose
Motion is assembly: modular pieces arrive in order, become legible, and lock into place. The same discipline used to compose a Mino shapes how Tetrifox interfaces move — then they stay put.
### Rules
#### Must
- **Make motion feel like assembly — deliberate, confident and mechanical. Never playful, bouncy or decorative.** Assemble. Reveal. Settle. echoes the modular pieces finding their place that underpin the brand: Minos, tetrominoes, the bordered grid. [Assemble. Reveal. Settle.](https://design.tetrifox.com/foundations/motion#assemble-reveal-settle) · `motion.assembly`
- **Use `motion/react` for entrances and CSS transitions for hover and focus only (colour and transform, about 200ms). No raw `@keyframes` and no second animation library.** One engine for entrances and one for micro-interactions keeps every timing traceable to the shared presets. Tokens: `transitions.fast`. [Assemble. Reveal. Settle.](https://design.tetrifox.com/foundations/motion#assemble-reveal-settle) · `motion.tooling`
- **Sequence groups with the exported stagger variants instead of local numeric delay ladders.** An existing stagger preset already expresses the order; a local ladder drifts from it. Tokens: `variants.staggerContainer`, `variants.staggerContainerSlow`, `variants.gridStagger`. [Presets](https://design.tetrifox.com/foundations/motion#presets) · `motion.stagger-presets`
- **Animate only `opacity` and `transform`. The `draw` preset, which animates SVG `pathLength` for instructional line work, is the one exception; never animate width, height, padding or layout.** Composited properties stay smooth and never shift the layout a reader is following. Tokens: `variants.draw`. [Presets](https://design.tetrifox.com/foundations/motion#presets) · `motion.opacity-transform`
- **Let the effective preference — system, reduced or full — govern Motion components, CSS micro-interactions, smooth anchor scrolling and the pattern field together.** Reduced motion changes presentation, not meaning; one switch must cover every moving surface. [Reduced motion](https://design.tetrifox.com/foundations/motion#reduced-motion) · `motion.effective-preference`
- **Give every moving surface a named reduced state: in reduced mode content renders settled, anchor links jump, and the pattern field paints one static lattice with no animation frame or pointer listener.** A surface without a named reduced state does not move at all. [Reduced motion](https://design.tetrifox.com/foundations/motion#reduced-motion) · `motion.reduced-settled`
- **Fire reveals once (`viewport once: true`): hero content on mount, section headers and grid content on first entry, illustrations after their text.** Re-triggering on scroll-back turns orientation into decoration. Tokens: `variants.fadeUp`, `variants.fadeIn`. [What moves](https://design.tetrifox.com/foundations/motion#what-moves) · `motion.once`
- **Keep the pattern field the only ambient motion: inside a contained cell, only while visible, and only when the effective preference allows it.** The drifting dots embody the assembly metaphor. Their physics live in the component; their colours are the field tokens. Tokens: `--field-dot`, `--field-glow`, `--field-bloom`. [What moves](https://design.tetrifox.com/foundations/motion#what-moves) · `motion.pattern-exception`
#### Must not
- **Hardcode durations, easings, transitions or variant objects. Import them from `src/lib/motion.ts`.** If you catch yourself writing `transition={{ duration: 0.4, ease: [...] }}`, stop and import instead. Tokens: `transitions.default`, `variants.fadeUp`. [Presets](https://design.tetrifox.com/foundations/motion#presets) · `motion.import-presets`
- **Use parallax, scroll-linked effects or exit animations, or animate header and footer chrome, borders or grid lines.** Content assembles, reveals and settles. Then it stays put. [What moves](https://design.tetrifox.com/foundations/motion#what-moves) · `motion.never`
#### Prefer
- **Use `transitions.reveal` (0.8s, easeOut) for scroll reveals and `transitions.fast` (0.2s, snappy) for hovers. Choose a preset by purpose, not taste.** Each pairing of duration and easing has one job. Tokens: `transitions.reveal`, `transitions.fast`, `easings.easeOut`, `easings.snappy`. [Presets](https://design.tetrifox.com/foundations/motion#presets) · `motion.reveal-and-hover`
### Tokens used
| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--field-dot` | `#9aa5b1` | `#52606d` |
| `--field-glow` | `#408cb4` | `#0891b2` |
| `--field-bloom` | `#2bc4f0` | `#10add9` |
| Token | Value | Source |
| --- | --- | --- |
| `transitions.fast` | `{"duration":0.2,"ease":[0.4,0,0.2,1]}` | src/lib/motion.ts |
| `transitions.default` | `{"duration":0.4,"ease":[0.25,0.1,0.25,1]}` | src/lib/motion.ts |
| `variants.fadeUp` | `{"hidden":{"opacity":0,"y":24},"visible":{"opacity":1,"y":0}}` | src/lib/motion.ts |
| `variants.staggerContainer` | `{"hidden":{},"visible":{"transition":{"staggerChildren":0.12}}}` | src/lib/motion.ts |
| `variants.staggerContainerSlow` | `{"hidden":{},"visible":{"transition":{"staggerChildren":0.2,"delayChildren":0.1}}}` | src/lib/motion.ts |
| `variants.gridStagger` | `{"hidden":{},"visible":{"transition":{"staggerChildren":0.08}}}` | src/lib/motion.ts |
| `transitions.reveal` | `{"duration":0.8,"ease":[0,0,0.2,1]}` | src/lib/motion.ts |
| `easings.easeOut` | `[0,0,0.2,1]` | src/lib/motion.ts |
| `easings.snappy` | `[0.4,0,0.2,1]` | src/lib/motion.ts |
| `variants.draw` | `{"hidden":{"pathLength":0,"opacity":0},"visible":{"pathLength":1,"opacity":1}}` | src/lib/motion.ts |
| `variants.fadeIn` | `{"hidden":{"opacity":0},"visible":{"opacity":1}}` | src/lib/motion.ts |
### Do / Don't
- **Presets.** Do: `` Don't: ``
- **Restraint.** Do: A section header fades up once and settles. Don't: A hero image drifts with scroll position and fades out on exit.
### Related chapters
- [Layout & grid](https://design.tetrifox.com/foundations/layout.md)
- [Components](https://design.tetrifox.com/expressions/components.md)
- [Minos & configurations](https://design.tetrifox.com/expressions/minos.md)
---
## 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)
---
## Voice & tone
> Foundations · Tetrifox Brand Book · https://design.tetrifox.com/foundations/voice
### Purpose
Tetrifox writes to be quoted. One fixed position, a protected vocabulary, and four tests: clear over clever, structured over prose-heavy, evidence-led, assemblous — not flashy.
### Rules
#### Must
- **Reinforce the positioning statement on every surface — hero sections, meta descriptions, about pages, external content. Variations are fine; contradictions are not.** The phrasing can move. The position cannot: Tetrifox is a product engineering partner that builds modular software development teams — called Minos — for startups and scale-ups that need to move from idea to production fast. [Positioning](https://design.tetrifox.com/foundations/voice#positioning) · `voice.positioning`
- **Use Mino / Minos, JOIST and the three-layer model exactly as capitalised here. Define each on first use, then use it consistently.** These are Tetrifox terms, not interchangeable marketing language. [Proprietary terms](https://design.tetrifox.com/foundations/voice#proprietary-terms) · `voice.protected-terms`
- **Write Tetrifox as one word, always capitalised.** The name is a proper noun, never a styled wordmark in copy. [Proprietary terms](https://design.tetrifox.com/foundations/voice#proprietary-terms) · `voice.tetrifox`
- **Be clear over clever: plain, confident and precise. Explain; don't hype.** A technical position should survive in one sentence. [Principles](https://design.tetrifox.com/foundations/voice#principles) · `voice.clear`
- **Prefer definitions, frameworks, comparison tables, numbered lists and step-by-step breakdowns over prose blocks.** Structure is what people and machines can lift and reuse. [Principles](https://design.tetrifox.com/foundations/voice#principles) · `voice.structured`
- **Back claims with specific metrics and numbers, especially in case studies, and keep each figure attached to its own claim and source.** Specific evidence is what gets cited. [Principles](https://design.tetrifox.com/foundations/voice#principles) · `voice.evidence`
- **Write FAQs as real questions people ask: an `
` question and a concise two-to-three-sentence answer, optionally with a list. Pages with FAQs carry `FAQPage` JSON-LD.** Generic filler answers nothing; structured questions are what search and LLMs surface. [Do / Don't](https://design.tetrifox.com/foundations/voice#do-dont) · `voice.faq`
- **Structure every case study as Problem → Approach → Decisions → Outcome → Lessons learned, with specific numbers throughout.** One arc makes case studies comparable and citable. [Do / Don't](https://design.tetrifox.com/foundations/voice#do-dont) · `voice.case-study-arc`
#### Must not
- **Invent a new proprietary term, or rename an existing one — no “squad” for Mino, no expanded or lower-case JOIST.** A silent alias splits the vocabulary that makes Tetrifox quotable. [Proprietary terms](https://design.tetrifox.com/foundations/voice#proprietary-terms) · `voice.no-aliases`
- **Merge separate facts into one quotation, or publish a claim without a source.** A composed display must never be mistaken for something Tetrifox said. [Do / Don't](https://design.tetrifox.com/foundations/voice#do-dont) · `voice.no-synthetic-quotes`
#### Prefer
- **Write copy a person or an LLM can quote verbatim: clear definitions and frameworks, and service pages that each answer one concrete question (“What is a Mino?”).** The goal is to become the default answer when someone asks about product engineering, scaling dev teams, or building software in Europe — not to rank for clicks. [Positioning](https://design.tetrifox.com/foundations/voice#positioning) · `voice.citable`
- **Sound assemblous, not flashy: deliberate, modular, settled — the voice mirrors the motion.** Short clauses that resolve read like parts locking into place. [Principles](https://design.tetrifox.com/foundations/voice#principles) · `voice.assemblous`
- **Keep the voice fixed and adapt the tone by surface: a case study, an error message and a founder's note dial the same voice up or down.** _(Extension)_ An operational distinction inferred from the fixed-voice doctrine. [Principles](https://design.tetrifox.com/foundations/voice#principles) · `voice.voice-vs-tone`
### Tokens used
This chapter's rules reference no tokens.
### Do / Don't
- **Position.** Do: Reinforce the same product-engineering position on every page. Don't: Change the offer to suit a headline.
- **Vocabulary.** Do: Introduce Mino, JOIST, and the three-layer model clearly, then preserve their names. Don't: Invent an alias or silently rename a proprietary term.
- **Structure.** Do: Answer concrete questions with definitions, frameworks, lists, and steps. Don't: Bury the answer in a prose block.
- **Evidence.** Do: Use specific facts and cite the exact source field. Don't: Turn separate facts into a quotation or publish an unsupported claim.
### Related chapters
- [Typography](https://design.tetrifox.com/foundations/typography.md)
- [Minos & configurations](https://design.tetrifox.com/expressions/minos.md)
- [Templates](https://design.tetrifox.com/expressions/templates.md)
---
## Images
> Expressions · Tetrifox Brand Book · https://design.tetrifox.com/expressions/images
### Purpose
A Tetrifox image earns its place twice: the subject makes the work legible, and its crop, grade, and rights can be defended.
### Rules
#### Must
- **Store an asset passport with every source file: creator or owner, licence evidence, territory, channels and duration, model and property releases, permitted transformations, crop and grade versions, alternative text, and the last rights review.** _(Extension)_ Rights travel with the asset. Missing evidence is a production hold, not a field to complete from memory. [Asset passport](https://design.tetrifox.com/expressions/images#asset-passport) · `images.passport`
- **Ship an image only when both decisions pass: creative fit and production clearance.** _(Extension)_ The subject can pass while the asset stays on hold. Visual quality cannot replace rights evidence. [Approve or reject](https://design.tetrifox.com/expressions/images#decision) · `images.two-decisions`
#### Must not
- **Use arbitrary stock or polished scenery because its palette happens to fit.** _(Extension)_ No crop or grade fixes a missing argument. [Subject & crop](https://design.tetrifox.com/expressions/images#subject-crop) · `images.no-arbitrary-stock`
- **Add an orange wash, keep a second warm accent hue, or use grading or motion to rescue a weak image.** _(Extension)_ Treatment controls the light, not the subject; orange stays the one accent. [The grade](https://design.tetrifox.com/expressions/images#grade) · `images.no-orange-wash`
#### Prefer
- **Choose images of systems made legible or people doing accountable work, mid-action rather than performing for the camera.** _(Extension)_ The subject is the evidence. It has to connect to product engineering, modular systems or accountable work. [Subject & crop](https://design.tetrifox.com/expressions/images#subject-crop) · `images.accountable-subject`
- **Set the crop to protect the action or the system — the hands and tool, the whole vessel and its direction — and keep enough field for scale.** _(Extension)_ A crop protects evidence; it cannot manufacture meaning the source never had. [Subject & crop](https://design.tetrifox.com/expressions/images#subject-crop) · `images.crop-protects`
- **On hover-capable pointers, rest restrained images in grayscale and return them to colour on hover (`grayscale group-hover:grayscale-0`, about 500ms). Touch keeps colour; reduced motion removes the transition.** The change carries no information, so it must never hide any. [The grade](https://design.tetrifox.com/expressions/images#grade) · `images.documented-hover`
- **Grade so that one warm band survives: residual colour leans cold, shadows meet the dark field, and highlights stop before type loses command.** _(Extension)_ The image joins the dark-first field while orange in the subject still reads. Warm coverage is reported as evidence, never as a pass mark. Tokens: `--background`, `--color-brand-500`. [The grade](https://design.tetrifox.com/expressions/images#grade) · `images.warm-band`
- **Ship reviewed, pre-graded derivatives. Runtime pixel work belongs only in the teaching bench.** _(Extension)_ A graded file is reviewable; a runtime filter is not. [The grade](https://design.tetrifox.com/expressions/images#grade) · `images.pre-graded`
### Tokens used
| Token | Dark (`:root`) | Light (`.light`) |
| --- | --- | --- |
| `--background` | `#0a0d12` | `#ffffff` |
| `--color-brand-500` | `#f97316` | `#f97316` |
### Do / Don't
- **Subject.** Do: A cargo ship seen from above: a complex system made legible, the orange belonging to the subject. Don't: A bright landscape with no link to product engineering, graded until it matches the palette.
- **Clearance.** Do: Creative fit passes, rights are recorded, the asset ships. Don't: Creative fit passes, rights are missing, the asset ships anyway.
### Related chapters
- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Materials](https://design.tetrifox.com/expressions/materials.md)
- [Templates](https://design.tetrifox.com/expressions/templates.md)
---
## Materials
> Expressions · Tetrifox Brand Book · https://design.tetrifox.com/expressions/materials
### Purpose
Before a material direction enters the system, record its substance, finish, source, and use. A reference image begins the inquiry. It does not complete the evidence.
### Rules
#### Must
- **Qualify a material before it enters the system: name the substance precisely, record the finish a crop must preserve, keep the source (provider, permission, channels, transformations) with the asset, and approve a real use.** _(Extension)_ Substance, finish, source and use are the four questions every direction has to answer. [Qualification standard](https://design.tetrifox.com/expressions/materials#machined-not-molded) · `materials.qualify`
- **Release a direction only when all four gates are recorded — identity, provenance, sample or crop, application. The first incomplete gate is the next action.** _(Extension)_ Gates make the release decision derivable instead of a matter of taste. [Usage](https://design.tetrifox.com/expressions/materials#usage) · `materials.four-gates`
#### Must not
- **Let a material direction override the shipped digital rules. Surfaces stay dark-first, semantic, square and closed.** _(Extension)_ The physical lens is derived from the digital system, not the other way round. [Qualification standard](https://design.tetrifox.com/expressions/materials#machined-not-molded) · `materials.digital-first`
- **Treat a reference photograph as approval. Every candidate direction stays an extension until its source, sample and real application are recorded.** _(Extension)_ A photograph is not an approval. [Candidate registry](https://design.tetrifox.com/expressions/materials#the-palette) · `materials.reference-not-approval`
#### Prefer
- **Use the founder story for posture — leadership close to difficult work, care that makes contribution safe, energy without self-centring — never as a reason to approve a palette.** _(Extension)_ Responsibility explains the standard. Evidence still decides whether a material can enter the system. [Tending to the fire](https://design.tetrifox.com/expressions/materials#tending-the-fire) · `materials.posture-not-palette`
- **Brief each candidate with its digital translation rule and its prohibition, not only its photograph.** _(Extension)_ The brief is what turns a reference into something a maker can commission. [Usage](https://design.tetrifox.com/expressions/materials#usage) · `materials.translation-rule`
### Tokens used
This chapter's rules reference no tokens.
### Do / Don't
- **Evidence.** Do: Hot-dip galvanised zinc with provider, sample and an approved application recorded. Don't: A moody photograph of metal added to the palette because it looks right.
### Related chapters
- [Images](https://design.tetrifox.com/expressions/images.md)
- [Colour](https://design.tetrifox.com/foundations/colour.md)
- [Layout & grid](https://design.tetrifox.com/foundations/layout.md)
---
## Minos & configurations
> Expressions · Tetrifox Brand Book · https://design.tetrifox.com/expressions/minos
### Purpose
Consultancy, technical leadership, and engineering delivered as one accountable unit. The problem sets the composition; the Mino carries it into production.
### Rules
#### Must
- **Define a Mino as consultancy, technical leadership and engineering delivered as one embedded, accountable unit — never as “a team” or “a squad” alone.** A Mino is not just a team—it’s consultancy, technical leadership, and engineering delivered as one embedded unit. We start by understanding your business problem, then build the capability to solve it. [What a Mino is](https://design.tetrifox.com/expressions/minos#what-is-a-mino) · `minos.definition`
- **Name all three layers, in order, when introducing the model: Strategic Consultancy, Technical Leadership, Engineering.** The three-layer model is protected vocabulary; its order is the argument (business problem first, then direction, then delivery). [What a Mino is](https://design.tetrifox.com/expressions/minos#what-is-a-mino) · `minos.three-layers`
- **Use the five JOIST configurations with their sourced descriptors: J-Mino (Ops enhanced), O-Mino (Balanced), I-Mino (Dev-heavy), S-Mino (Strategic Unit), T-Mino (Test-focused).** Each Tetris shape tells you the competency emphasis at a glance. [Configurations](https://design.tetrifox.com/expressions/minos#configurations) · `minos.joist`
- **Start every Mino with consultancy: in copy, in process and in diagrams.** “Every Mino starts with consultancy, not code.” (Home · How we work) [The anchor law](https://design.tetrifox.com/expressions/minos#the-anchor-law) · `minos.consultancy-first`
#### Must not
- **Invent use cases or role mappings for a configuration. Only I, J and T have sourced use cases; O and S keep their descriptors alone.** A Mino claim without a source is an invented brand fact. [Configurations](https://design.tetrifox.com/expressions/minos#configurations) · `minos.no-invented-scenarios`
#### Prefer
- **Describe how a Mino forms as four steps: understand the problem, design the Mino, embed and deliver, adapt and scale.** The composition follows a business challenge, not a staffing request. [What a Mino is](https://design.tetrifox.com/expressions/minos#what-is-a-mino) · `minos.problem-first`
- **Frame JOIST as the load-bearing beam the unit rests on only as a gloss, never as a sourced claim.** _(Extension)_ The five letters are sourced; the beam reading is the book's framing. [Configurations](https://design.tetrifox.com/expressions/minos#configurations) · `minos.beam`
- **In Mino diagrams, keep the consultancy cell fixed and orange while the rest of the silhouette changes. Do not present cell coordinates or orientations as a specification.** _(Extension)_ The source specifies no geometry; the fixed anchor is an illustration of consultancy-first doctrine. [The anchor law](https://design.tetrifox.com/expressions/minos#the-anchor-law) · `minos.anchor-geometry`
### Tokens used
This chapter's rules reference no tokens.
### Do / Don't
- **Definition.** Do: A Mino: consultancy, technical leadership, and engineering delivered as one accountable unit. Don't: Our Mino squads are flexible dev teams.
- **Configurations.** Do: T-Mino (Test-focused): hardening quality before a major release. Don't: O-Mino: perfect for greenfield AI projects.
### Related chapters
- [Voice & tone](https://design.tetrifox.com/foundations/voice.md)
- [Layout & grid](https://design.tetrifox.com/foundations/layout.md)
- [Components](https://design.tetrifox.com/expressions/components.md)
---
## 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 ``, 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 `