LogoLockup
The Balance mark and the outlined Fair Case wordmark, as one link home. The server draws the still mark; the people-led entrance plays once per tab when script runs.
The lockup
On a light ground and a dark one, with the 10.5px clear space dashed. Drawn as static HTML, so it shows the end state of the motion.
Code
TSX
<LogoLockup label="Fair Case" />The docs site's header draws it with its own hover: <LogoLockup href="/docs" label="Fair Case" className="rounded-4 text-fg transition-tone hover:text-accent" />. The sizes, colours and clear space are on the Brand page.
Motion
The entrance plays only where script runs. This page ships none for it, so it shows the end state. The sequence's times are on the Brand page.
| Rule | How it works |
|---|---|
| Plays | Once per tab. The first load with the mark plays it; every reload and later page in that tab shows the still mark. Reduced motion shows the still mark every time. |
| Length | 3130ms, then the exact still artwork. It never loops. |
| Decided | Before first paint, by a head script that sets data-logo-motion="ready" on <html> only when the motion will play. |
| Remembered | In session storage under fc:logo-played. If storage throws, the still mark stays. |
| Fallback | If nothing claims the mark within 4000ms, for example because hydration failed, the head script removes the marker. |
Colour
| Prop | Value | How it looks |
|---|---|---|
| mark | light pages | #B2D5FF (--fc-rule). Both people and the wordmark take the link's text colour. |
| mark | dark pages | #7EB7FF (--fc-dark-accent). |
States
| State | How it looks |
|---|---|
| rest | The still Balance mark, then the outlined wordmark, 9px apart, in one link. |
| entrance | Plays once per tab when script runs, over 3130ms. It needs script, so this site shows the end state, the still mark. |
| no motion | Reduced motion, no script, blocked storage and every later visit in the tab show the still mark. |
| hover | not written in the component. A caller sets it on the link, as the docs header does. |
| focus | The global 2px focus ring with a 2px gap. |
| narrow row | not written in the component. A header too narrow for the wordmark hides it with its own style (decision 0104). |
Props
Import from @repo/ui/brand/logo-lockup.
| Prop | Type | Default | What it does |
|---|---|---|---|
| label | string | default required | The accessible name, "Fair Case". Both drawings are hidden from assistive technology, so the name is the link's text. |
| markClassName | string | undefined | The mark's fill classes. The default is the light blue on light pages and the dark blue on dark pages; a header on a fixed dark bar passes its own. | |
| className | string | Extra classes on the link. | |
| href | string | default "/" | Where the link goes. The default is home. |
| lang | string | undefined | The language of the name, such as en for the brand name on another language's page. It goes on the name itself. | |
| ...rest | Omit<ComponentProps<"a">, "children"> | The other anchor props. |
Use it well
Pass label. It is the link's only text, so without it the link has no name.
Use one tone per surface: the light blue on light pages, the dark blue on dark pages. A permanently dark header passes the dark blue through markClassName.
Keep 10.5px clear on every side of the lockup, and never stretch the mark.
The mark comes before the wordmark, even on right-to-left pages; the link sets dir=ltr on itself.