Skip to content
Design System
GitHub

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.

--motion-fast · 120msPress feedback, hover
--motion-base · 200msState changes, spring-back, switches
--motion-sheet · 320msSheets and panels in and out

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, collapse

Patterns

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.

Patrol route saved
Appearpatterns.appear · 200 ms · rise 8 px
Sensors
Lidar · normalCamera · normalIMU · normal
Sheetpatterns.sheet · 320 ms
Press.press · 120 ms · scale 0.97Hold the button
Swappatterns.swap · 120 ms
MovelayoutId · 200 ms · the selection travels to its new placePick a view

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.

  • 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.

  1. 120 ms

    Press feedback appears

  2. 200 ms

    Slide to release springs back

  3. 300 ms

    Spinner may appear; faster work shows none

  4. 1.2 s

    Skeleton breath cycle

  5. 1.5 s

    No reply from the robot: stop is marked unconfirmed, Bluetooth takes over

  6. 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.

  • 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.

Released
Do. Animate the change from stopped to released.
New
Don't. Loop animations to draw the eye. A pulsing badge competes with the emergency stop.