Also enforces the ban on the AI motion signature (opacity:0 + translateY(20px) + ease-in-out applied uniformly to every entrance).
Runs only after the static body/component exists (design-web, design-webapp, design-ios, design-android) — never used to hide or compensate for an unfinished layout.
Design Motion — Timing, Easing, Materials, Restraint
When
After the static body/component exists. Motion is applied on top of a settled layout —
never used to compensate for or distract from an unfinished one. Hands off to
design-review next (Part 1 checks the reduced-motion fallback + transform/opacity
discipline; Part 2's motion-verdict.md issues the Block/Approve).
Input
design-system.md motion personality / MOTION_INTENSITY dial (1-10).
- The static markup/components to animate.
The animation gate — before writing any motion code
Run every candidate through references/animation-decision-framework.md's 4 questions,
in order: (1) should this animate at all — frequency decides, never animate
keyboard-initiated or 100+/day actions; (2) what's the one-sentence purpose (spatial
consistency / state indication / explanation / feedback / preventing jarring change); (3)
what easing; (4) what duration. Most "let's animate this" ideas should die at question 1
— that is the point, not a formality to skip.
Materials — transform/opacity first, other properties gated
Default to transform and opacity — they skip layout and paint and run on the GPU.
Animating width/height/top/left/margin/padding triggers layout+paint+composite
and drops frames; see references/motion-performance.md for the Framer Motion shorthand
caveat (x/y/scale shorthands are NOT hardware-accelerated, use the full transform
string), the CSS-var recalc trap (never drive child transforms via a custom property on
the parent), CSS transitions vs. keyframes for interruptible UI, and velocity-based drag
dismissal (~0.11 threshold, not distance alone). Other atmospheric materials — blur,
backdrop-filter, clip-path, shadow bloom, masks — are allowed when they demonstrably read
as premium and stay smooth on the target viewports, verified in-browser, never a default
reach; keep expensive effects bounded to small/isolated areas. references/motion-physics.md
covers physical-correctness rules for whichever material is used: never scale(0),
origin-aware popovers, asymmetric enter/exit timing (exit ~75% of enter duration),
staggered lists (cap total stagger time), blur masking, @starting-style.
Durations — the 100/300/500 rule
| Tier |
Duration |
Use |
| Micro |
100-150ms |
button press, toggle, instant feedback |
| State |
200-300ms |
menu open, tooltip, hover states |
| Layout |
300-500ms |
accordion, modal, drawer |
| Entrance |
500-800ms |
page load, hero reveal |
Exit animations run at ~75% of the matching enter duration. Hard rule for anything that
isn't a marketing/explanatory sequence: UI feedback stays under 300ms — a 180ms
dropdown reads as more responsive than a 400ms one
(references/animation-decision-framework.md §4).
Easing — exponential/emphasized, no bounce
Entering/exiting → ease-out. Moving/morphing on-screen (A→B) or state toggles →
ease-in-out. Hover/color change → ease. Constant motion (marquee, progress) →
linear. Never ease-in on UI — it delays the exact moment the user is watching
most closely. Use the strong custom curves in references/motion-tokens.md
(--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out, --ease-drawer) or the
exponential/quint-out family (cubic-bezier(0.16, 1, 0.3, 1) and similar) — never the
weak built-in CSS easings. Bounce and elastic curves are banned outright — they read
as a toy interaction, not a premium one. Hard mechanical gate, zero tolerance: any
cubic-bezier with a y-control-point > 1, or the literal elastic/bounce keywords,
fails design-review/references/pre-flight-checklist.md check 9. Springs (when used —
gesture-driven/interruptible motion only) keep bounce in 0.1-0.3, biased toward 0.1
for dashboards/product register and up to 0.3 for playful/brand register.
Reduced motion — mandatory, not optional
Every animated deliverable ships a prefers-reduced-motion: reduce fallback in the same
commit — never a follow-up pass. Full patterns: references/reduced-motion.md (global
override, Framer Motion's useReducedMotion()/MotionConfig, per-animation-type
disable-vs-simplify table, WCAG 2.2 SC 2.3.3/2.3.1/2.2.2). Disable spatial movement
entirely (parallax, auto-playing carousels, zoom/scale transitions — vestibular risk);
simplify functional feedback rather than remove it (progress bars and loading spinners
stay, slowed and non-spatial; page-slide transitions become an instant swap that keeps
navigation feedback). ~35% of adults over 40 are affected by vestibular disorders — this
is not an edge case. design-review Part 1 treats a missing reduced-motion fallback as a
Critical-severity finding (audit-checklist.md Motion row) that blocks the review.
Ban — the AI motion signature
The single most common AI-generated motion tell: opacity: 0 + translateY(20px) +
ease-in-out, applied uniformly to every entrance on the page with zero variation by
element role. (No figure is attached to this one: the "~83%" belongs to the
palette/font/radius triad and to it alone — see ../design-method/SKILL.md
§Absolute bans. Never borrow it for another ban or detector.) Vary
instead: stagger timing and entrance direction/distance by section role, easing chosen
per the Q3 decision table above, duration chosen per the tier table above — never one
blanket transition rule copy-pasted down every section. design-review catches leftovers
of this at pre-flight-checklist.md check 4 (motion-claimed-motion-shown: a declared
MOTION_INTENSITY > 4 must ship actual motion code) and check 10 (layout-property
animation, warning-tier), plus the co-occurrence detectors in anti-ai-slop-audit.md.
Steps
- Gate every candidate animation through
references/animation-decision-framework.md.
- Pick the duration tier (table above) and the easing token from
references/motion-tokens.md.
- Choose the material —
transform/opacity by default; consult
references/motion-physics.md for physical correctness and
references/motion-performance.md for the GPU/perf guardrails before reaching for
anything else.
- Apply the category pattern:
references/entrance-patterns.md (stagger/fade/slide/scale),
references/micro-interactions.md (buttons/toggles/copy actions/loading),
references/page-transitions.md (route changes/drill-down/modal),
references/patterns-buttons.md / references/patterns-cards.md /
references/patterns-navigation.md / references/patterns-microinteractions.md for
component-specific treatments, references/interactive-states-ref.md for
hover/active/focus/disabled/loading state choreography.
references/gsap-scroll-skeletons.md for pinned/scroll-driven sections (Sticky-Stack,
Horizontal-Pan) — carries the same motion-claimed/motion-shown honesty rule as the ban
above. references/glassmorphism-advanced-ref.md and
references/layered-backgrounds-ref.md are gated-use references (blur/layering
effects), never a default reach — see design-method's cluster 4 AI-slop warning
(glassmorphism + rounded-2xl applied everywhere instead of gated).
- Ship the reduced-motion fallback in the same pass — not a follow-up.
- Name every effect in the handoff/spec using
references/animation-glossary.md's
feel→term vocabulary ("the springy thing when a popover opens" → the exact word) —
precise handoff, not vibes.
Failure Handling
- An effect needs blur/filter/backdrop-filter and visibly drops frames on target
viewports → fall back to transform/opacity only, note the tradeoff in the handoff.
- A purely spatial effect (e.g. parallax) has no sane reduced form → disable entirely
under the media query rather than approximate a "lite" version.
Output
- Animated component/page reusing motion tokens (durations/easings) from
references/motion-tokens.md — never hand-rolled per instance.
prefers-reduced-motion fallback shipped in the same pass.
- Effects named per
references/animation-glossary.md for handoff to design-review or
another agent.
Next → design-review — Part 1 checks the reduced-motion fallback and the
transform/opacity discipline mechanically; Part 2's motion-verdict.md issues the
Block/Approve on feel, physicality, and accessibility.
References
| File |
Purpose |
references/animation-decision-framework.md |
The 4-question gate — run first, every time |
references/motion-performance.md |
GPU/perf guardrails, Framer Motion caveat, drag velocity |
references/motion-tokens.md |
Named easing curves + spring configs (the token layer) |
references/motion-physics.md |
Physical-correctness rules (never scale(0), origin, stagger, @starting-style) |
references/reduced-motion.md |
Mandatory — media query, Framer Motion hooks, WCAG 2.2, disable-vs-simplify table |
references/animation-glossary.md |
Feel → term vocabulary for specs/handoff |
references/entrance-patterns.md |
Stagger/fade/slide/scale entrance patterns |
references/micro-interactions.md |
Button/toggle/copy-action/loading micro-animations |
references/page-transitions.md |
Route changes, drill-down, modal transitions |
references/patterns-buttons.md |
Button component motion patterns |
references/patterns-cards.md |
Card motion/hover patterns |
references/patterns-navigation.md |
Navigation/responsive-navbar motion |
references/patterns-microinteractions.md |
Broader micro-interaction/transition patterns |
references/interactive-states-ref.md |
Hover/active/focus/disabled/loading state choreography |
references/motion-principles.md |
Motion hierarchy, duration scale, easing — general principles |
references/motion-patterns.md |
Framer Motion pattern library, timing guidelines |
references/gsap-scroll-skeletons.md |
Scroll-driven/pinned skeletons + motion-claimed/motion-shown rule |
references/glassmorphism-advanced-ref.md |
Gated-use glass effects (blur/layering) — never default |
references/layered-backgrounds-ref.md |
Gated-use gradient orbs/blur layers/noise textures |
1---2name: design-motion3description: "Use when adding or reviewing motion on an already-settled layout or component — never to hide or compensate for an unfinished one."4when-to-use: "After the static body/component exists (design-web/design-webapp/design-ios/design-android) and motion is being added or reviewed — never to hide an unfinished layout."5keywords: motion, animation, easing, duration, transform, opacity, reduced-motion, ai-slop6priority: high7related: design-web, design-webapp, design-review, design-system8metadata:9 source: https://skillmd.com/skills/fusengine/design-motion10---1112<objective>13A motion pass applied on top of an already-settled layout: the animation-decision gate (should this even animate, what's its purpose, what easing, what duration), transform/opacity-first materials, the 100/300/500ms duration scale, exponential/emphasized easing curves (bounce and elastic are banned outright), and the mandatory `prefers-reduced-motion` fallback shipped in the same pass.1415Also enforces the ban on the AI motion signature (`opacity:0 + translateY(20px) + ease-in-out` applied uniformly to every entrance).1617Runs only after the static body/component exists (`design-web`, `design-webapp`, `design-ios`, `design-android`) — never used to hide or compensate for an unfinished layout.18</objective>1920## Design Motion — Timing, Easing, Materials, Restraint2122### When23After the static body/component exists. Motion is applied on top of a settled layout —24never used to compensate for or distract from an unfinished one. Hands off to25`design-review` next (Part 1 checks the reduced-motion fallback + transform/opacity26discipline; Part 2's `motion-verdict.md` issues the Block/Approve).2728### Input29- `design-system.md` motion personality / `MOTION_INTENSITY` dial (1-10).30- The static markup/components to animate.3132### The animation gate — before writing any motion code33Run every candidate through `references/animation-decision-framework.md`'s 4 questions,34in order: (1) should this animate at all — frequency decides, never animate35keyboard-initiated or 100+/day actions; (2) what's the one-sentence purpose (spatial36consistency / state indication / explanation / feedback / preventing jarring change); (3)37what easing; (4) what duration. Most "let's animate this" ideas should die at question 138— that is the point, not a formality to skip.3940### Materials — transform/opacity first, other properties gated41Default to `transform` and `opacity` — they skip layout and paint and run on the GPU.42Animating `width`/`height`/`top`/`left`/`margin`/`padding` triggers layout+paint+composite43and drops frames; see `references/motion-performance.md` for the Framer Motion shorthand44caveat (`x`/`y`/`scale` shorthands are NOT hardware-accelerated, use the full `transform`45string), the CSS-var recalc trap (never drive child transforms via a custom property on46the parent), CSS transitions vs. keyframes for interruptible UI, and velocity-based drag47dismissal (~0.11 threshold, not distance alone). Other atmospheric materials — blur,48backdrop-filter, clip-path, shadow bloom, masks — are allowed when they demonstrably read49as premium and stay smooth on the target viewports, verified in-browser, never a default50reach; keep expensive effects bounded to small/isolated areas. `references/motion-physics.md`51covers physical-correctness rules for whichever material is used: never `scale(0)`,52origin-aware popovers, asymmetric enter/exit timing (exit ~75% of enter duration),53staggered lists (cap total stagger time), blur masking, `@starting-style`.5455### Durations — the 100/300/500 rule5657| Tier | Duration | Use |58|---|---|---|59| Micro | 100-150ms | button press, toggle, instant feedback |60| State | 200-300ms | menu open, tooltip, hover states |61| Layout | 300-500ms | accordion, modal, drawer |62| Entrance | 500-800ms | page load, hero reveal |6364Exit animations run at ~75% of the matching enter duration. Hard rule for anything that65isn't a marketing/explanatory sequence: **UI feedback stays under 300ms** — a 180ms66dropdown reads as more responsive than a 400ms one67(`references/animation-decision-framework.md` §4).6869### Easing — exponential/emphasized, no bounce70Entering/exiting → `ease-out`. Moving/morphing on-screen (A→B) or state toggles →71`ease-in-out`. Hover/color change → `ease`. Constant motion (marquee, progress) →72`linear`. **Never `ease-in` on UI** — it delays the exact moment the user is watching73most closely. Use the strong custom curves in `references/motion-tokens.md`74(`--ease-out: cubic-bezier(0.23, 1, 0.32, 1)`, `--ease-in-out`, `--ease-drawer`) or the75exponential/quint-out family (`cubic-bezier(0.16, 1, 0.3, 1)` and similar) — never the76weak built-in CSS easings. **Bounce and elastic curves are banned outright** — they read77as a toy interaction, not a premium one. Hard mechanical gate, zero tolerance: any78`cubic-bezier` with a y-control-point > 1, or the literal `elastic`/`bounce` keywords,79fails `design-review/references/pre-flight-checklist.md` check 9. Springs (when used —80gesture-driven/interruptible motion only) keep `bounce` in **0.1-0.3**, biased toward 0.181for dashboards/product register and up to 0.3 for playful/brand register.8283### Reduced motion — mandatory, not optional84Every animated deliverable ships a `prefers-reduced-motion: reduce` fallback in the same85commit — never a follow-up pass. Full patterns: `references/reduced-motion.md` (global86override, Framer Motion's `useReducedMotion()`/`MotionConfig`, per-animation-type87disable-vs-simplify table, WCAG 2.2 SC 2.3.3/2.3.1/2.2.2). Disable spatial movement88entirely (parallax, auto-playing carousels, zoom/scale transitions — vestibular risk);89simplify functional feedback rather than remove it (progress bars and loading spinners90stay, slowed and non-spatial; page-slide transitions become an instant swap that keeps91navigation feedback). ~35% of adults over 40 are affected by vestibular disorders — this92is not an edge case. `design-review` Part 1 treats a missing reduced-motion fallback as a93**Critical**-severity finding (`audit-checklist.md` Motion row) that blocks the review.9495### Ban — the AI motion signature96The single most common AI-generated motion tell: `opacity: 0` + `translateY(20px)` +97`ease-in-out`, applied uniformly to every entrance on the page with zero variation by98element role. (No figure is attached to this one: the "~83%" belongs to the99palette/font/radius triad and to it alone — see `../design-method/SKILL.md`100§Absolute bans. Never borrow it for another ban or detector.) Vary101instead: stagger timing and entrance direction/distance by section role, easing chosen102per the Q3 decision table above, duration chosen per the tier table above — never one103blanket transition rule copy-pasted down every section. `design-review` catches leftovers104of this at `pre-flight-checklist.md` check 4 (motion-claimed-motion-shown: a declared105`MOTION_INTENSITY > 4` must ship actual motion code) and check 10 (layout-property106animation, warning-tier), plus the co-occurrence detectors in `anti-ai-slop-audit.md`.107108### Steps1091. Gate every candidate animation through `references/animation-decision-framework.md`.1102. Pick the duration tier (table above) and the easing token from `references/motion-tokens.md`.1113. Choose the material — `transform`/`opacity` by default; consult112 `references/motion-physics.md` for physical correctness and113 `references/motion-performance.md` for the GPU/perf guardrails before reaching for114 anything else.1154. Apply the category pattern: `references/entrance-patterns.md` (stagger/fade/slide/scale),116 `references/micro-interactions.md` (buttons/toggles/copy actions/loading),117 `references/page-transitions.md` (route changes/drill-down/modal),118 `references/patterns-buttons.md` / `references/patterns-cards.md` /119 `references/patterns-navigation.md` / `references/patterns-microinteractions.md` for120 component-specific treatments, `references/interactive-states-ref.md` for121 hover/active/focus/disabled/loading state choreography.122 `references/gsap-scroll-skeletons.md` for pinned/scroll-driven sections (Sticky-Stack,123 Horizontal-Pan) — carries the same motion-claimed/motion-shown honesty rule as the ban124 above. `references/glassmorphism-advanced-ref.md` and125 `references/layered-backgrounds-ref.md` are gated-use references (blur/layering126 effects), never a default reach — see design-method's cluster 4 AI-slop warning127 (glassmorphism + `rounded-2xl` applied everywhere instead of gated).1285. Ship the reduced-motion fallback in the same pass — not a follow-up.1296. Name every effect in the handoff/spec using `references/animation-glossary.md`'s130 feel→term vocabulary ("the springy thing when a popover opens" → the exact word) —131 precise handoff, not vibes.132133### Failure Handling134- An effect needs blur/filter/backdrop-filter and visibly drops frames on target135 viewports → fall back to transform/opacity only, note the tradeoff in the handoff.136- A purely spatial effect (e.g. parallax) has no sane reduced form → disable entirely137 under the media query rather than approximate a "lite" version.138139### Output140- Animated component/page reusing motion tokens (durations/easings) from141 `references/motion-tokens.md` — never hand-rolled per instance.142- `prefers-reduced-motion` fallback shipped in the same pass.143- Effects named per `references/animation-glossary.md` for handoff to `design-review` or144 another agent.145146### Next → `design-review` — Part 1 checks the reduced-motion fallback and the147transform/opacity discipline mechanically; Part 2's `motion-verdict.md` issues the148Block/Approve on feel, physicality, and accessibility.149150### References151| File | Purpose |152|------|---------|153| `references/animation-decision-framework.md` | **The 4-question gate — run first, every time** |154| `references/motion-performance.md` | GPU/perf guardrails, Framer Motion caveat, drag velocity |155| `references/motion-tokens.md` | Named easing curves + spring configs (the token layer) |156| `references/motion-physics.md` | Physical-correctness rules (never `scale(0)`, origin, stagger, `@starting-style`) |157| `references/reduced-motion.md` | **Mandatory** — media query, Framer Motion hooks, WCAG 2.2, disable-vs-simplify table |158| `references/animation-glossary.md` | Feel → term vocabulary for specs/handoff |159| `references/entrance-patterns.md` | Stagger/fade/slide/scale entrance patterns |160| `references/micro-interactions.md` | Button/toggle/copy-action/loading micro-animations |161| `references/page-transitions.md` | Route changes, drill-down, modal transitions |162| `references/patterns-buttons.md` | Button component motion patterns |163| `references/patterns-cards.md` | Card motion/hover patterns |164| `references/patterns-navigation.md` | Navigation/responsive-navbar motion |165| `references/patterns-microinteractions.md` | Broader micro-interaction/transition patterns |166| `references/interactive-states-ref.md` | Hover/active/focus/disabled/loading state choreography |167| `references/motion-principles.md` | Motion hierarchy, duration scale, easing — general principles |168| `references/motion-patterns.md` | Framer Motion pattern library, timing guidelines |169| `references/gsap-scroll-skeletons.md` | Scroll-driven/pinned skeletons + motion-claimed/motion-shown rule |170| `references/glassmorphism-advanced-ref.md` | Gated-use glass effects (blur/layering) — never default |171| `references/layered-backgrounds-ref.md` | Gated-use gradient orbs/blur layers/noise textures |