Motion design
Motion is a sentence about what just changed. An animation that does not say where something came
from, that input registered, or that work is under way is decoration the user waits through.
When this fires
Transitions, animated state changes, gesture-driven movement or loading indicators are being
added, changed or reviewed — or an interface reads as janky, slow, or unexplained.
Procedure
- Give each motion a job, in one sentence. The honest jobs are: continuity (this came from
there), feedback (your input registered), status (something is still happening), and attention
(this changed and you would have missed it). Motion with no job gets cut — that is the cheapest
improvement available here.
- Set duration from the size of the change, not from taste. Small local feedback is nearly
instant (around a tenth of a second); ordinary component transitions sit in the low hundreds of
milliseconds; large or full-screen surfaces take somewhat longer. Past roughly half a second
the user is waiting on you, and it must buy something. Shorter is the safer error.
- Choose easing from the direction of travel. Elements entering the screen decelerate into
place; elements leaving accelerate out; elements moving between two on-screen positions ease
both ends. Reserve linear for continuous or indeterminate loops, where easing would read as a
pulse.
- Anchor the movement to its trigger. A panel opens from the control that opened it; a row
expands in place; a dismissed item leaves the way a user pushed it. Movement that starts
somewhere unrelated to the tap breaks the continuity it was meant to provide.
- Make it interruptible. A second input during an animation must be honoured immediately and
the motion must reverse or retarget from where it currently is, not restart from the beginning
and not queue. A transition that swallows input, or that must finish before the UI responds,
is a defect regardless of how it looks.
- Implement the reduced-motion path deliberately. Respect the OS-level reduced-motion
preference, and treat it as a substitution rather than a deletion: a cross-fade or an immediate
state change, so the change is still legible. Never carry information only in the movement —
if the animation is the only thing saying an item was added or removed, the still frame must
say it too.
- Keep stagger small and bounded. A short per-item delay across the first few items, then
nothing. A list that ripples for a second is slower than a list that appears.
- Prefer properties the compositor can animate — transform and opacity — over animating
layout geometry, which recomputes layout every frame. When a property's cost is not obvious,
measure rather than assume.
- Watch it run, repeatedly, on the slowest target you have. Loop it; play it with the CPU
throttled; play it on a device, not only a desktop browser. Motion is the thing that reads
correct in the source and wrong on screen, and what you notice on the tenth viewing the user
notices on the second. Reading the CSS is not watching the animation.
Checklist
Failure handling
- "It feels slow" — separate the animation from the wait behind it. Shortening a transition
that is covering a two-second fetch fixes nothing; the fix is a status motion plus a faster
fetch, and those are two different findings.
- Stutter or dropped frames — profile before tuning. Guessing at duration when the cause is a
layout-thrashing property produces a shorter bad animation.
- It looks right in the browser and wrong on device — trust the device. Say which one you
observed on; never generalize one smooth desktop run to "animation verified".
- No way to observe it running — say motion was not observed, report what the code specifies,
and do not describe it as checked. Reduced-motion behaviour in particular is only confirmed by
running with the preference set.
- A motion carries meaning nothing else carries — that is an accessibility defect, not a
tuning question. Raise it rather than quietly shortening the animation.
Evidence to report
Each animation, its stated job, its duration and easing, and the property it animates; what you
saw when you interrupted it; what the reduced-motion path does and whether you actually ran with
the preference set; the device or throttling conditions you observed under; and any motion you
changed the timing of without being able to watch it.
1---2name: motion-design3description: Decide what an animation is communicating, then give it a duration, an easing curve, an interruption behaviour and a reduced-motion fallback. Use when adding or reviewing transitions, when a screen feels sluggish or jumpy, when implementing motion specified in a design, or when animation needs to survive users who ask for less of it. Not for static visual design, and not for general performance profiling of code that has no animation.4---56# Motion design78Motion is a sentence about what just changed. An animation that does not say where something came9from, that input registered, or that work is under way is decoration the user waits through.1011## When this fires1213Transitions, animated state changes, gesture-driven movement or loading indicators are being14added, changed or reviewed — or an interface reads as janky, slow, or unexplained.1516## Procedure17181. **Give each motion a job, in one sentence.** The honest jobs are: continuity (this came from19 there), feedback (your input registered), status (something is still happening), and attention20 (this changed and you would have missed it). Motion with no job gets cut — that is the cheapest21 improvement available here.222. **Set duration from the size of the change, not from taste.** Small local feedback is nearly23 instant (around a tenth of a second); ordinary component transitions sit in the low hundreds of24 milliseconds; large or full-screen surfaces take somewhat longer. Past roughly half a second25 the user is waiting on you, and it must buy something. Shorter is the safer error.263. **Choose easing from the direction of travel.** Elements entering the screen decelerate into27 place; elements leaving accelerate out; elements moving between two on-screen positions ease28 both ends. Reserve linear for continuous or indeterminate loops, where easing would read as a29 pulse.304. **Anchor the movement to its trigger.** A panel opens from the control that opened it; a row31 expands in place; a dismissed item leaves the way a user pushed it. Movement that starts32 somewhere unrelated to the tap breaks the continuity it was meant to provide.335. **Make it interruptible.** A second input during an animation must be honoured immediately and34 the motion must reverse or retarget from where it currently is, not restart from the beginning35 and not queue. A transition that swallows input, or that must finish before the UI responds,36 is a defect regardless of how it looks.376. **Implement the reduced-motion path deliberately.** Respect the OS-level reduced-motion38 preference, and treat it as a substitution rather than a deletion: a cross-fade or an immediate39 state change, so the change is still legible. Never carry information only in the movement —40 if the animation is the only thing saying an item was added or removed, the still frame must41 say it too.427. **Keep stagger small and bounded.** A short per-item delay across the first few items, then43 nothing. A list that ripples for a second is slower than a list that appears.448. **Prefer properties the compositor can animate** — transform and opacity — over animating45 layout geometry, which recomputes layout every frame. When a property's cost is not obvious,46 measure rather than assume.479. **Watch it run, repeatedly, on the slowest target you have.** Loop it; play it with the CPU48 throttled; play it on a device, not only a desktop browser. Motion is the thing that reads49 correct in the source and wrong on screen, and what you notice on the tenth viewing the user50 notices on the second. Reading the CSS is not watching the animation.5152## Checklist5354- [ ] Each animation's job stated, or the animation removed55- [ ] Durations scaled to the size of the moving element, nothing gratuitously long56- [ ] Easing matches enter / exit / move-between; linear only for continuous loops57- [ ] Motion originates at its trigger58- [ ] Interrupting mid-flight reverses or retargets, and input is never blocked59- [ ] Reduced-motion path substitutes rather than strips, and no meaning lives only in movement60- [ ] Observed running, at least once on a slow path, not only inferred from code61- [ ] Loading and indeterminate states still readable at their slowest6263## Failure handling6465- **"It feels slow"** — separate the animation from the wait behind it. Shortening a transition66 that is covering a two-second fetch fixes nothing; the fix is a status motion plus a faster67 fetch, and those are two different findings.68- **Stutter or dropped frames** — profile before tuning. Guessing at duration when the cause is a69 layout-thrashing property produces a shorter bad animation.70- **It looks right in the browser and wrong on device** — trust the device. Say which one you71 observed on; never generalize one smooth desktop run to "animation verified".72- **No way to observe it running** — say motion was not observed, report what the code specifies,73 and do not describe it as checked. Reduced-motion behaviour in particular is only confirmed by74 running with the preference set.75- **A motion carries meaning nothing else carries** — that is an accessibility defect, not a76 tuning question. Raise it rather than quietly shortening the animation.7778## Evidence to report7980Each animation, its stated job, its duration and easing, and the property it animates; what you81saw when you interrupted it; what the reduced-motion path does and whether you actually ran with82the preference set; the device or throttling conditions you observed under; and any motion you83changed the timing of without being able to watch it.