Motion
Movement only marks a change of state: pressed, opened, stopped, released. Nothing moves to decorate or to attract attention.
Durations
Three tokens. Press Play to compare them.
Easing
Two curves. What arrives or changes responds at once and settles softly. What leaves starts gently and speeds away, so it never lingers in a slow tail.
--ease-standardcubic-bezier(0.2, 0, 0, 1)Arrivals and every state change; transitions--ease-exitcubic-bezier(0.3, 0, 1, 1)Exits only: disappear, sheets closing, collapsePatterns
Six patterns cover every state change; the table under In the components lists them and where each is used. This site shows five here: pages and tab panels appear, the mobile menu opens as a sheet, controls press, icons swap, and the current-page marker moves.
CSS uses the tokens directly (duration-(--motion-base) ease-(--ease-standard)). JavaScript animation (motion/react) imports the same values from site/motion.ts; a unit test fails if they drift from the theme file.
In the components
Every component uses one of the patterns, from the theme. CI fails a component that skips them.
| Pattern | Utility | Components |
|---|---|---|
| Appear / disappear | animate-appear · animate-disappear | Dialog, Alert dialog, Popover, Dropdown menu, Select, Tooltip, Toast, Alert, Alarm, island notices, tab panels, field errors |
| Sheet | animate-sheet-in-* · animate-sheet-out-* | Sheet (bottom, right, left); scrims fade in with animate-fade-in |
| Expand / collapse | animate-expand · animate-collapse | Accordion |
| Press | press | Button, Toggle, Segmented control, Emergency stop, Dock, island zones, list rows, app-shell navigation |
| Swap | transition-[opacity,scale] · duration-(--motion-fast) ease-(--ease-standard) | Copy button, Command (the check on a picked row), Table and Data grid sort arrows, Image grid selection |
| Move | transition · duration-(--motion-base) ease-(--ease-standard) | Switch thumb, Slide to release, Progress |
- Appear / disappear
- Utility
animate-appear · animate-disappear- Components
- Dialog, Alert dialog, Popover, Dropdown menu, Select, Tooltip, Toast, Alert, Alarm, island notices, tab panels, field errors
- Sheet
- Utility
animate-sheet-in-* · animate-sheet-out-*- Components
- Sheet (bottom, right, left); scrims fade in with animate-fade-in
- Expand / collapse
- Utility
animate-expand · animate-collapse- Components
- Accordion
- Press
- Utility
press- Components
- Button, Toggle, Segmented control, Emergency stop, Dock, island zones, list rows, app-shell navigation
- Swap
- Utility
transition-[opacity,scale] · duration-(--motion-fast) ease-(--ease-standard)- Components
- Copy button, Command (the check on a picked row), Table and Data grid sort arrows, Image grid selection
- Move
- Utility
transition · duration-(--motion-base) ease-(--ease-standard)- Components
- Switch thumb, Slide to release, Progress
npm run lint:motion checks that overlays animate in and out, that every button presses, and that no component writes its own duration or easing.
Timing rules
Shared across products, so every app behaves the same under pressure.
- 120 ms
Press feedback appears
- 200 ms
Slide to release springs back
- 300 ms
Spinner may appear; faster work shows none
- 1.2 s
Skeleton breath cycle
- 1.5 s
No reply from the robot: stop is marked unconfirmed, Bluetooth takes over
- 2 s
Hold to stop all; hold Enter or Space to release
Between pages
Going to another page swaps the content, not the frame: the old content disappears, the new one appears, and the header, navigation and anything safety-critical stay where they are. This site does it; try the sidebar.
| Part | How | Tokens |
|---|---|---|
| Old content | Fades out | --motion-fast · --ease-exit |
| New content | Fades in and rises 8 px, after the old one has gone | --motion-base · --ease-standard |
| Header, navigation, stop, island | Stay still and stay live | not in the transition |
- Old content
- How
- Fades out
- Tokens
--motion-fast · --ease-exit
- New content
- How
- Fades in and rises 8 px, after the old one has gone
- Tokens
--motion-base · --ease-standard
- Header, navigation, stop, island
- How
- Stay still and stay live
- Tokens
not in the transition
Built on React's <ViewTransition> around the content only, with :root { view-transition-name: none } and ::view-transition { pointer-events: none }. While a view transition runs, whatever takes part in it cannot be clicked, and by default the whole page takes part: measured in Chromium, a stop button did not respond for the length of the animation. So the root never takes part, the stop and the island are never inside a transition, and on a robot app that only switches sections, use no page transition at all.
Reduced motion
When the system asks for reduced motion, every duration drops to 0.01 ms and the skeleton stops breathing. State still changes; it just does not travel.