Motion
Motion provides feedback, not decoration
Motion responds to actions and explains spatial changes. Use only the documented durations, easing roles, and micro-interactions. Every moving state must respect prefers-reduced-motion.
Durations
Choose duration by the size of the change. Larger surfaces may take longer, but repeated operational actions stay fast so the interface remains responsive.
| Token | Duration | Use |
|---|---|---|
| motion.duration.fast | 120 ms | Hover, focus, and small control-state changes |
| motion.duration.base | 200 ms | Default for most transitions |
| motion.duration.slow | 320 ms | Drawers, dialogs, and larger surfaces |
| motion.duration.deliberate | 480 ms | Rare editorial movement |
motion.duration.fastmotion.duration.basemotion.duration.slowmotion.duration.deliberate
Easing
Use the standard easing for ordinary transitions, enter easing for a surface that arrives, and exit easing for a surface that leaves. Do not use bounce, spring, or overshoot curves.
motion.easing.standardmotion.easing.entermotion.easing.exit
The approved micro-interactions
The system permits three authored movements: an arrow-link response, a product-image crossfade, and the primary-action hover lift. A view may also use one entrance reveal on its hero. Everything else changes colour or shadow without moving layout.
A reveal is opt-in and may hide content only when JavaScript is available and reduced motion is not requested. Without JavaScript or with reduced motion, the content is visible immediately.
motion-role.controlmotion-role.surfacemotion.duration.slowmotion-role.ease-enter
When not to animate
Do not animate changing data, prices, stock values, page navigation, scrolling, or printed output. Never use scroll hijacking or parallax. When the operating system requests reduced motion, keep every optional movement still.
Custom elements and stable layout
Drawers, dialogs, and tabs must not shift layout while their custom elements load. Overlays reserve no space. Layout elements reserve their final space before enhancement. Design the stable state first.