Motion Design
Purpose
Design the motion language for a feature or system, including transition specs, micro-interaction definitions, choreography principles, and reduced-motion alternatives.
Inputs
- Feature or component requiring motion design
- Existing animation patterns in the project (if any)
- Performance constraints (target FPS, device capabilities)
- Accessibility requirements (prefers-reduced-motion support)
Process
Step 1: Identify Motion Opportunities
Catalog where motion adds meaning:
- State transitions: Loading → loaded, collapsed → expanded, hidden → visible
- Navigation transitions: Screen push/pop, modal present/dismiss, tab switch
- Feedback responses: Button press, form submission, error shake, success check
- Attention guidance: New item appears, notification badge, scroll-to-target
- Data changes: List reorder, item add/remove, value count-up
Step 2: Define Motion Principles
Establish the motion language for this project:
- Duration scale: Micro (100ms), short (200ms), medium (300ms), long (500ms)
- Easing curves: Enter (ease-out), exit (ease-in), standard (ease-in-out)
- Stagger: Delay between sequential items (50-100ms per item, max 5 items)
- Distance: How far elements travel relative to their size
Step 3: Spec Each Animation
For each motion opportunity, define:
- Property: What changes (opacity, transform, height, color)
- Duration: How long (from the duration scale)
- Easing: Which curve (from the easing set)
- Delay: When it starts relative to the trigger
- Direction: Where it moves from/to
Step 4: Design Choreography
For multi-element transitions:
- Entrance order: What appears first, second, third
- Stagger timing: Delay between each element
- Shared elements: Elements that morph between states
- Exit choreography: Reverse of entrance, or distinct exit pattern
Step 5: Reduced-Motion Alternatives
For every animation, define the prefers-reduced-motion alternative:
- Instant transitions: Replace motion with opacity crossfade
- Remove parallax: Static positioning instead
- Simplify choreography: Single fade-in instead of staggered entrance
- Keep functional animation: Loading spinners stay (they communicate state)
Step 6: Performance Considerations
Verify motion feasibility:
- Composite-only properties: Prefer transform and opacity (GPU-accelerated)
- Avoid layout thrash: Don't animate width, height, top, left
- will-change hints: Add for elements that will animate
- 60fps budget: Each frame must complete in <16.6ms
Output Format
# Motion Design Specification
## Motion Principles
| Property | Value | Usage |
|----------|-------|-------|
| Duration (micro) | 100ms | Hover, focus |
| Duration (short) | 200ms | Expand, collapse |
| Duration (medium) | 300ms | Page transitions |
| Ease (enter) | cubic-bezier(0, 0, 0.2, 1) | Elements appearing |
| Ease (exit) | cubic-bezier(0.4, 0, 1, 1) | Elements leaving |
| Stagger | 50ms | List items |
## Animation Specs
### [Component/Interaction Name]
**Trigger:** [User action or state change]
**Property:** [What changes]
**From → To:** [Start value → End value]
**Duration:** [From scale]
**Easing:** [From set]
**Reduced motion:** [Alternative]
## Choreography
### [Transition Name]
1. [Element] fades in at 0ms (200ms, ease-out)
2. [Element] slides up at 50ms (200ms, ease-out)
3. [Element] fades in at 100ms (200ms, ease-out)
## Reduced Motion Summary
| Animation | Full Motion | Reduced Motion |
|-----------|------------|----------------|
| Page enter | Slide + fade | Instant fade |
| List stagger | Staggered slide-up | Single fade |
| Loading | Spinner | Spinner (kept) |
Quality Checks
Evolution Notes
1---2name: motion-design3description: Animation principles, micro-interaction specs, and reduced-motion support4---56# Motion Design78## Purpose910Design the motion language for a feature or system, including transition specs, micro-interaction definitions, choreography principles, and reduced-motion alternatives.1112## Inputs1314- Feature or component requiring motion design15- Existing animation patterns in the project (if any)16- Performance constraints (target FPS, device capabilities)17- Accessibility requirements (prefers-reduced-motion support)1819## Process2021### Step 1: Identify Motion Opportunities2223Catalog where motion adds meaning:24- **State transitions:** Loading → loaded, collapsed → expanded, hidden → visible25- **Navigation transitions:** Screen push/pop, modal present/dismiss, tab switch26- **Feedback responses:** Button press, form submission, error shake, success check27- **Attention guidance:** New item appears, notification badge, scroll-to-target28- **Data changes:** List reorder, item add/remove, value count-up2930### Step 2: Define Motion Principles3132Establish the motion language for this project:33- **Duration scale:** Micro (100ms), short (200ms), medium (300ms), long (500ms)34- **Easing curves:** Enter (ease-out), exit (ease-in), standard (ease-in-out)35- **Stagger:** Delay between sequential items (50-100ms per item, max 5 items)36- **Distance:** How far elements travel relative to their size3738### Step 3: Spec Each Animation3940For each motion opportunity, define:41- **Property:** What changes (opacity, transform, height, color)42- **Duration:** How long (from the duration scale)43- **Easing:** Which curve (from the easing set)44- **Delay:** When it starts relative to the trigger45- **Direction:** Where it moves from/to4647### Step 4: Design Choreography4849For multi-element transitions:50- **Entrance order:** What appears first, second, third51- **Stagger timing:** Delay between each element52- **Shared elements:** Elements that morph between states53- **Exit choreography:** Reverse of entrance, or distinct exit pattern5455### Step 5: Reduced-Motion Alternatives5657For every animation, define the prefers-reduced-motion alternative:58- **Instant transitions:** Replace motion with opacity crossfade59- **Remove parallax:** Static positioning instead60- **Simplify choreography:** Single fade-in instead of staggered entrance61- **Keep functional animation:** Loading spinners stay (they communicate state)6263### Step 6: Performance Considerations6465Verify motion feasibility:66- **Composite-only properties:** Prefer transform and opacity (GPU-accelerated)67- **Avoid layout thrash:** Don't animate width, height, top, left68- **will-change hints:** Add for elements that will animate69- **60fps budget:** Each frame must complete in <16.6ms7071## Output Format7273```markdown74# Motion Design Specification7576## Motion Principles77| Property | Value | Usage |78|----------|-------|-------|79| Duration (micro) | 100ms | Hover, focus |80| Duration (short) | 200ms | Expand, collapse |81| Duration (medium) | 300ms | Page transitions |82| Ease (enter) | cubic-bezier(0, 0, 0.2, 1) | Elements appearing |83| Ease (exit) | cubic-bezier(0.4, 0, 1, 1) | Elements leaving |84| Stagger | 50ms | List items |8586## Animation Specs8788### [Component/Interaction Name]89**Trigger:** [User action or state change]90**Property:** [What changes]91**From → To:** [Start value → End value]92**Duration:** [From scale]93**Easing:** [From set]94**Reduced motion:** [Alternative]9596## Choreography97### [Transition Name]981. [Element] fades in at 0ms (200ms, ease-out)992. [Element] slides up at 50ms (200ms, ease-out)1003. [Element] fades in at 100ms (200ms, ease-out)101102## Reduced Motion Summary103| Animation | Full Motion | Reduced Motion |104|-----------|------------|----------------|105| Page enter | Slide + fade | Instant fade |106| List stagger | Staggered slide-up | Single fade |107| Loading | Spinner | Spinner (kept) |108```109110## Quality Checks111112- [ ] Every animation has a purpose (communicates state change, guides attention, or provides feedback)113- [ ] Duration and easing values come from the defined scale, not arbitrary values114- [ ] Every animation has a prefers-reduced-motion alternative115- [ ] Animations use composite-only properties (transform, opacity) where possible116- [ ] Stagger timing doesn't exceed 5 items (cap the stagger, fade the rest)117- [ ] No animation exceeds 500ms (users perceive delays >400ms as laggy)118119## Evolution Notes120<!-- Observations appended after each use -->