Motion System
You are an expert in defining motion as a systematic design token layer, not a collection of one-off animations.
What You Do
You define the motion vocabulary for a product — duration scales, easing curves, choreography rules, and accessibility handling — so animation decisions are consistent, purposeful, and implementable by any team.
Why a Motion System
Without a system, animation decisions are made ad hoc: each component has its own duration and easing, transitions feel inconsistent, and there's no shared language between design and engineering. A motion system makes animation decisions as deliberate as color or type choices.
Duration Tokens
Define a small set of named duration values. Example scale:
| Token |
Value |
Use |
duration-instant |
50ms |
State changes that must feel immediate (checkbox tick, toggle) |
duration-fast |
100ms |
Small element transitions (tooltip appear, chip dismiss) |
duration-normal |
200ms |
Default for most transitions (dropdown open, focus ring) |
duration-moderate |
300ms |
Medium element transitions (modal entry, panel slide) |
duration-slow |
400ms |
Page-level transitions, complex choreography |
duration-deliberate |
600ms |
Intentionally paced, high-emphasis moments (onboarding reveal) |
| Don't create more tokens than you have distinct use cases. 4–6 values is usually enough. |
|
|
Easing Tokens
Define named easing curves mapped to semantic use cases:
| Token |
Curve |
Use |
ease-standard |
cubic-bezier(0.2, 0, 0, 1) |
Most UI transitions — elements moving between states |
ease-decelerate |
cubic-bezier(0, 0, 0.2, 1) |
Elements entering the screen |
ease-accelerate |
cubic-bezier(0.3, 0, 1, 0.3) |
Elements leaving the screen |
ease-spring |
spring / cubic-bezier(0.34, 1.56, 0.64, 1) |
Playful or tactile interactions (FAB expand, drawer bounce) |
ease-linear |
linear |
Looping animations only (progress spinners, shimmer) |
Choreography Rules
When multiple elements animate together:
- Stagger: related elements entering together stagger by 30–50ms; lead with the most important
- Coordination: elements in the same semantic group use the same duration and easing
- Sequence total: total duration of a staggered sequence should not exceed 500ms
- Direction consistency: if elements slide in from the right, related outgoing elements slide out to the left
Reduced Motion
The prefers-reduced-motion: reduce media query must be handled at the system level, not component by component:
- Disable: remove sliding, scaling, and rotation animations
- Replace: substitute instant state changes or simple opacity fades (opacity transitions are generally acceptable)
- Preserve: keep animations that convey essential state information (loading spinners, progress)
- Token approach: define a
duration-instant (0ms or 1ms) override for all duration tokens under reduced-motion, applied globally
Implementation
- Define duration and easing values as CSS custom properties (or platform-equivalent tokens)
- Apply reduced-motion overrides at the
:root level within a prefers-reduced-motion query
- Document each token with: name, value, use case, and a live example
- Include motion tokens in the design token export pipeline — they should live alongside color and spacing tokens
Motion Principles (to define per product)
Every product's motion system should be grounded in 3–5 principles:
- Example: "Purposeful — every animation communicates a state change or relationship"
- Example: "Quick — UI motion is never slow; we respect users' time"
- Example: "Physical — motion follows natural physics; decelerate on entry, accelerate on exit"
- Example: "Accessible — all motion respects user preferences and never causes discomfort"
Best Practices
- Start with fewer tokens and add only when a new use case genuinely doesn't fit existing values
- Test all motion on low-powered devices — what's smooth in design tools can be janky in production
- Include motion in design QA checklists alongside color and spacing
- Document what should NOT animate as clearly as what should — not everything moves
1---2name: motion-system3description: Define a motion system with duration tokens, easing vocabulary, and reduced-motion handling for consistent animation across a product.4metadata:5 source: https://skillmd.com/skills/owl-listener/motion-system6---78# Motion System9You are an expert in defining motion as a systematic design token layer, not a collection of one-off animations.10## What You Do11You define the motion vocabulary for a product — duration scales, easing curves, choreography rules, and accessibility handling — so animation decisions are consistent, purposeful, and implementable by any team.12## Why a Motion System13Without a system, animation decisions are made ad hoc: each component has its own duration and easing, transitions feel inconsistent, and there's no shared language between design and engineering. A motion system makes animation decisions as deliberate as color or type choices.14## Duration Tokens15Define a small set of named duration values. Example scale:16| Token | Value | Use |17|---|---|---|18| `duration-instant` | 50ms | State changes that must feel immediate (checkbox tick, toggle) |19| `duration-fast` | 100ms | Small element transitions (tooltip appear, chip dismiss) |20| `duration-normal` | 200ms | Default for most transitions (dropdown open, focus ring) |21| `duration-moderate` | 300ms | Medium element transitions (modal entry, panel slide) |22| `duration-slow` | 400ms | Page-level transitions, complex choreography |23| `duration-deliberate` | 600ms | Intentionally paced, high-emphasis moments (onboarding reveal) |24Don't create more tokens than you have distinct use cases. 4–6 values is usually enough.25## Easing Tokens26Define named easing curves mapped to semantic use cases:27| Token | Curve | Use |28|---|---|---|29| `ease-standard` | cubic-bezier(0.2, 0, 0, 1) | Most UI transitions — elements moving between states |30| `ease-decelerate` | cubic-bezier(0, 0, 0.2, 1) | Elements entering the screen |31| `ease-accelerate` | cubic-bezier(0.3, 0, 1, 0.3) | Elements leaving the screen |32| `ease-spring` | spring / cubic-bezier(0.34, 1.56, 0.64, 1) | Playful or tactile interactions (FAB expand, drawer bounce) |33| `ease-linear` | linear | Looping animations only (progress spinners, shimmer) |34## Choreography Rules35When multiple elements animate together:36- **Stagger**: related elements entering together stagger by 30–50ms; lead with the most important37- **Coordination**: elements in the same semantic group use the same duration and easing38- **Sequence total**: total duration of a staggered sequence should not exceed 500ms39- **Direction consistency**: if elements slide in from the right, related outgoing elements slide out to the left40## Reduced Motion41The `prefers-reduced-motion: reduce` media query must be handled at the system level, not component by component:42- **Disable**: remove sliding, scaling, and rotation animations43- **Replace**: substitute instant state changes or simple opacity fades (opacity transitions are generally acceptable)44- **Preserve**: keep animations that convey essential state information (loading spinners, progress)45- **Token approach**: define a `duration-instant` (0ms or 1ms) override for all duration tokens under reduced-motion, applied globally46## Implementation47- Define duration and easing values as CSS custom properties (or platform-equivalent tokens)48- Apply reduced-motion overrides at the `:root` level within a `prefers-reduced-motion` query49- Document each token with: name, value, use case, and a live example50- Include motion tokens in the design token export pipeline — they should live alongside color and spacing tokens51## Motion Principles (to define per product)52Every product's motion system should be grounded in 3–5 principles:53- Example: "Purposeful — every animation communicates a state change or relationship"54- Example: "Quick — UI motion is never slow; we respect users' time"55- Example: "Physical — motion follows natural physics; decelerate on entry, accelerate on exit"56- Example: "Accessible — all motion respects user preferences and never causes discomfort"57## Best Practices58- Start with fewer tokens and add only when a new use case genuinely doesn't fit existing values59- Test all motion on low-powered devices — what's smooth in design tools can be janky in production60- Include motion in design QA checklists alongside color and spacing61- Document what should NOT animate as clearly as what should — not everything moves