[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C4CGQQG8EXDBPRK47XEYBJ":3,"skill-same:01M7C4CGQQG8EXDBPRK47XEYBJ":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M7C4CGQQG8EXDBPRK47XEYBJ","material-design-3-motion",null,"Applies Material Design 3 Expressive motion and animation principles to create natural, intuitive, and engaging user experiences. Use this when implementing animations, transitions, micro-interactions, or when the user asks to apply Material Design 3 motion guidelines.","pohlai88\u002Fafenda-xforge-v5","pohlai88","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F216658843?v=4","01M7C3ZWD8Y9WVZSNWJ6200V3P","01M7C3ZWDW077V142FSQEFJJ0B",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmaterial-design-3-motion\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: material-design-3-motion\ndescription: Applies Material Design 3 Expressive motion and animation principles to create natural, intuitive, and engaging user experiences. Use this when implementing animations, transitions, micro-interactions, or when the user asks to apply Material Design 3 motion guidelines.\nlicense: Apache-2.0\n---\n\n# Material Design 3 Motion and Animation\n\n## Overview\n\nThis skill guides the implementation of Material Design 3 (M3) Expressive motion principles to create springy, natural-feeling animations that enhance usability and delight users.\n\n**Keywords**: Material Design 3, M3, motion, animation, transitions, micro-interactions, easing, duration, spring physics, expressive motion, haptics, physics-based animation\n\n## Core Principles\n\n### Expressive Motion Philosophy\n\nM3 Expressive motion is designed to feel alive, natural, and responsive:\n\n1. **Physics-Based Springs**: Use spring-based animations governed by stiffness, damping, and velocity — replacing traditional cubic-bezier easing for more natural, lively motion\n2. **Purposeful Motion**: Every animation should serve a purpose—guiding attention, providing feedback, or showing relationships\n3. **Responsive Feel**: Motion responds to user input with appropriate speed and timing\n4. **Spatial Coherence**: Elements move in ways that respect spatial relationships and physics\n5. **Haptic Integration**: Pair spring animations with platform-native haptic feedback for tactile reinforcement\n\n### Motion Modes\n\n**Expressive Motion** (Default for M3 Expressive):\n- Overshoots, bounces, and adds energy\n- Ideal for touch interactions and hero moments\n- Creates a playful, emotionally resonant feel\n- Uses higher spring energy and pronounced bounce\n\n**Standard Motion** (Utilitarian flows):\n- Restrained, minimal bounce\n- Better for productivity-focused or system-critical flows\n- Natural feel without excess playfulness\n\n**Legacy Motion** (Compatibility):\n- Traditional easing for backwards compatibility\n- Use only when spring physics cannot be applied\n\n### Spring Physics Parameters\n\nM3 Expressive motion uses three key physics parameters instead of traditional time\u002Feasing curves:\n\n1. **Stiffness**: Controls how \"hard\" the spring is — higher stiffness means the animation finishes more quickly\n2. **Damping**: Determines how quickly the bounce fades out — a damping value of 1 eliminates bounce completely\n3. **Initial Velocity**: Sets the initial speed, influencing overall timing and feel\n\n| Scheme     | Stiffness | Damping | Bounce Effect |\n|------------|-----------|---------|---------------|\n| Expressive | High      | Medium  | Pronounced overshoot |\n| Standard   | Medium    | High    | Minimal\u002Fnone |\n\n## Animation Types\n\n### 1. Transitions\n\n**Enter Transitions** (Elements appearing):\n- Fade + Scale: Elements fade in while scaling from 80% to 100%\n- Fade + Slide: Elements slide in from edge while fading\n- Container Transform: Morphing one container into another\n\n**Exit Transitions** (Elements disappearing):\n- Fade + Scale: Elements scale down to 80% while fading out\n- Fade + Slide: Elements slide away while fading\n- Keep exits faster than enters (maintain forward momentum)\n\n**Shared Element Transitions** (Between screens\u002Fstates):\n- Morph containers smoothly between views\n- Maintain visual continuity\n- Use container transform pattern\n\n### 2. Micro-interactions\n\n**Hover States**:\n- Subtle elevation change (add shadow)\n- Color shift using state layer\n- Scale slightly (1.02x-1.05x)\n- Duration: 100-200ms\n\n**Focus States**:\n- Outline or ring animation\n- Scale or elevation change\n- Duration: 200-300ms\n\n**Press\u002FTouch States**:\n- Ripple effect from touch point\n- Scale down slightly (0.98x)\n- State layer with opacity\n- Duration: 100-150ms\n\n**Loading States**:\n- Shimmer or skeleton screens\n- Circular progress indicators\n- Linear progress bars\n- Continuous, smooth motion\n\n### 3. Complex Animations\n\n**Stagger Animations**:\n- Animate list items with incremental delay\n- Delay between items: 30-50ms\n- Creates cascade effect\n\n**Choreographed Animations**:\n- Multiple elements moving in coordination\n- Use animation-delay for orchestration\n- Maintain spatial relationships\n\n**Morphing Shapes**:\n- Smooth path interpolation between shapes\n- Variable corner radius transitions\n- Use for state changes and transformations\n\n## Duration Guidelines\n\n### Standard Durations\n\n**Extra Small** (50-100ms):\n- Icon state changes\n- Tooltip appearances\n- Simple opacity changes\n\n**Small** (100-200ms):\n- Button hover states\n- Simple scale animations\n- Color transitions\n\n**Medium** (200-300ms):\n- Modal dialogs\n- Navigation transitions\n- Card expansions\n\n**Large** (300-500ms):\n- Page transitions\n- Complex transformations\n- Sheet presentations\n\n**Extra Large** (500ms+):\n- Major state changes\n- Full screen transitions\n- Use sparingly\n\n### Context-Based Adjustments\n\n- **Mobile**: Slightly faster (0.8x-0.9x of base duration)\n- **Desktop**: Standard durations\n- **Reduced Motion**: Reduce to 10-20% of standard duration or disable\n- **Large Elements**: Increase duration proportionally\n\n## Spring Physics Implementation\n\n### Expressive Spring (Default for M3 Expressive)\n\n```css\n\u002F* CSS with expressive spring-like bezier approximation *\u002F\ntransition-timing-function: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n\n\u002F* Enhanced linear() for expressive spring with overshoot *\u002F\ntransition-timing-function: linear(\n  0, 0.004, 0.016 2.5%, 0.063 5%, 0.141, 0.25, \n  0.391 11.3%, 0.563, 0.765, 1.000 20%, 1.066 23.8%, \n  1.109 27.5%, 1.130 31.3%, 1.138 35%, 1.136 38.8%, \n  1.121 46.3%, 1.093 53.8%, 1.057 61.3%, 1.025 68.8%, \n  1.005 77.5%, 0.997 87.5%, 1\n);\n```\n\n### Standard Spring\n\n```css\n\u002F* CSS with standard spring-like bezier approximation *\u002F\ntransition-timing-function: cubic-bezier(0.2, 0.0, 0, 1.0);\n\n\u002F* CSS linear() for better standard spring approximation *\u002F\ntransition-timing-function: linear(\n  0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, \n  0.938 16.7%, 1.017, 1.077, 1.121, 1.149 24.3%, \n  1.159, 1.163, 1.161, 1.154 29.9%, 1.129 32.8%, \n  1.051 39.6%, 1.017 43.1%, 0.991, 0.977 51%, \n  0.974 53.8%, 0.975 57.1%, 0.997 69.8%, 1.003 76.9%, 1\n);\n```\n\n### JavaScript (Web Animations API)\n\n```javascript\n\u002F\u002F Expressive spring animation\nelement.animate(\n  [\n    { transform: 'scale(0)', opacity: 0 },\n    { transform: 'scale(1)', opacity: 1 }\n  ],\n  {\n    duration: 300,\n    easing: 'cubic-bezier(0.05, 0.7, 0.1, 1.0)',\n    fill: 'forwards'\n  }\n);\n\n\u002F\u002F Standard spring animation\nelement.animate(\n  [\n    { transform: 'translateY(20px)', opacity: 0 },\n    { transform: 'translateY(0)', opacity: 1 }\n  ],\n  {\n    duration: 250,\n    easing: 'cubic-bezier(0.2, 0.0, 0, 1.0)',\n    fill: 'forwards'\n  }\n);\n```\n\n### Choosing Expressive vs Standard Motion\n\n| Scenario | Motion Mode | Why |\n|----------|-------------|-----|\n| Button press feedback | Expressive | User-triggered, benefits from bounce |\n| Page transition | Standard | Functional, should not distract |\n| Loading completion | Expressive | Celebratory moment of delight |\n| Form validation | Standard | Utilitarian feedback |\n| FAB expansion | Expressive | Key interaction with visual emphasis |\n| List scroll | Standard | Continuous motion, should be smooth |\n| Shape morphing | Expressive | Visual storytelling moment |\n| Tooltip appearance | Standard | Informational, should not distract |\n\n## Haptics Integration\n\nM3 Expressive recommends pairing spring-driven animations with platform-native haptic feedback:\n\n### Principles\n\n1. **Coordinate with Motion**: Haptic effects should fire at the key moment of the animation (e.g., at the point of overshoot or completion)\n2. **Match Intensity**: Gentle haptics for subtle interactions, stronger for significant state changes\n3. **Platform-Native**: Use the platform's haptic engine for the most natural feel\n4. **Respect Preferences**: Honor user haptic settings and provide accessibility options\n\n### Web Implementation\n\n```javascript\n\u002F\u002F Pair haptic feedback with expressive motion\nfunction expressivePress(element) {\n  \u002F\u002F Trigger haptic feedback\n  if (navigator.vibrate) {\n    navigator.vibrate(10); \u002F\u002F Short, subtle haptic\n  }\n  \n  \u002F\u002F Trigger spring animation\n  element.animate([\n    { transform: 'scale(1)' },\n    { transform: 'scale(0.95)' },\n    { transform: 'scale(1.02)' },\n    { transform: 'scale(1)' }\n  ], {\n    duration: 300,\n    easing: 'cubic-bezier(0.05, 0.7, 0.1, 1.0)'\n  });\n}\n```\n\n## Implementation Patterns\n\n### Container Transform\n\nSmoothly morph from one container to another:\n\n```javascript\n\u002F\u002F Using View Transitions API (modern browsers)\ndocument.startViewTransition(() => {\n  \u002F\u002F Update DOM\n  container.classList.toggle('expanded');\n});\n\n\u002F\u002F CSS\n::view-transition-old(container),\n::view-transition-new(container) {\n  animation-duration: 300ms;\n  animation-timing-function: cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n```\n\n### Shared Axis Transition\n\nElements exit and enter along a shared axis:\n\n```css\n\u002F* X-axis shared transition *\u002F\n.exit-left {\n  animation: exit-left 300ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n.enter-right {\n  animation: enter-right 300ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n@keyframes exit-left {\n  from { transform: translateX(0); opacity: 1; }\n  to { transform: translateX(-100px); opacity: 0; }\n}\n\n@keyframes enter-right {\n  from { transform: translateX(100px); opacity: 0; }\n  to { transform: translateX(0); opacity: 1; }\n}\n```\n\n### Elevation Change\n\nAnimate elevation with shadow and transform:\n\n```css\n.elevated-card {\n  transition: \n    box-shadow 200ms cubic-bezier(0.2, 0.0, 0, 1.0),\n    transform 200ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n.elevated-card:hover {\n  box-shadow: \n    0px 4px 8px rgba(0, 0, 0, 0.12),\n    0px 8px 16px rgba(0, 0, 0, 0.08);\n  transform: translateY(-2px);\n}\n```\n\n### Ripple Effect\n\nMaterial ripple for touch feedback:\n\n```css\n.ripple {\n  position: relative;\n  overflow: hidden;\n}\n\n.ripple::after {\n  content: '';\n  position: absolute;\n  top: 50%;\n  left: 50%;\n  width: 0;\n  height: 0;\n  border-radius: 50%;\n  background: rgba(255, 255, 255, 0.5);\n  transform: translate(-50%, -50%);\n  transition: width 0.3s, height 0.3s;\n}\n\n.ripple:active::after {\n  width: 300%;\n  height: 300%;\n}\n```\n\n## Best Practices\n\n### Do's\n\n1. ✅ Use spring physics for natural motion\n2. ✅ Match animation duration to element size (larger = longer)\n3. ✅ Provide immediate feedback for user interactions\n4. ✅ Use motion to show relationships between elements\n5. ✅ Test animations on lower-end devices\n6. ✅ Respect prefers-reduced-motion setting\n7. ✅ Use stagger animations to make large datasets feel lighter\n8. ✅ Keep motion purposeful and functional\n\n### Don'ts\n\n1. ❌ Don't use linear easing (feels mechanical)\n2. ❌ Don't animate too many properties simultaneously\n3. ❌ Don't make animations too slow (feels sluggish)\n4. ❌ Don't ignore accessibility preferences\n5. ❌ Don't use motion purely for decoration\n6. ❌ Don't animate layout properties excessively (causes reflow)\n7. ❌ Don't use different easing curves randomly\n\n## Accessibility\n\n### Reduced Motion\n\nAlways respect user preferences:\n\n```css\n@media (prefers-reduced-motion: reduce) {\n  * {\n    animation-duration: 0.01ms !important;\n    animation-iteration-count: 1 !important;\n    transition-duration: 0.01ms !important;\n  }\n}\n```\n\n### Focus Indicators\n\nEnsure animated focus states are still visible:\n- Maintain adequate contrast\n- Don't rely solely on motion for focus indication\n- Use both color and shape changes\n\n### Performance\n\n- Prefer `transform` and `opacity` (GPU accelerated)\n- Avoid animating `width`, `height`, `top`, `left` (causes layout reflow)\n- Use `will-change` sparingly for complex animations\n- Test on mobile devices and low-end hardware\n\n## Motion Tokens\n\nDefine motion tokens for consistency. M3 Expressive introduces tokenized spring-based motion:\n\n```css\n:root {\n  \u002F* Durations *\u002F\n  --md-sys-motion-duration-short1: 50ms;\n  --md-sys-motion-duration-short2: 100ms;\n  --md-sys-motion-duration-short3: 150ms;\n  --md-sys-motion-duration-short4: 200ms;\n  --md-sys-motion-duration-medium1: 250ms;\n  --md-sys-motion-duration-medium2: 300ms;\n  --md-sys-motion-duration-medium3: 350ms;\n  --md-sys-motion-duration-medium4: 400ms;\n  --md-sys-motion-duration-long1: 450ms;\n  --md-sys-motion-duration-long2: 500ms;\n  --md-sys-motion-duration-long3: 550ms;\n  --md-sys-motion-duration-long4: 600ms;\n  \n  \u002F* Easing — Standard (utilitarian) *\u002F\n  --md-sys-motion-easing-standard: cubic-bezier(0.2, 0.0, 0, 1.0);\n  --md-sys-motion-easing-standard-decelerate: cubic-bezier(0.0, 0.0, 0, 1.0);\n  --md-sys-motion-easing-standard-accelerate: cubic-bezier(0.3, 0.0, 1.0, 1.0);\n  \n  \u002F* Easing — Expressive (default for M3 Expressive) *\u002F\n  --md-sys-motion-easing-expressive: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-expressive-decelerate: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-expressive-accelerate: cubic-bezier(0.3, 0.0, 0.8, 0.15);\n  \n  \u002F* Easing — Emphasized (legacy naming, same as expressive) *\u002F\n  --md-sys-motion-easing-emphasized: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-emphasized-decelerate: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-emphasized-accelerate: cubic-bezier(0.3, 0.0, 0.8, 0.15);\n  \n  \u002F* Legacy easing *\u002F\n  --md-sys-motion-easing-legacy: cubic-bezier(0.4, 0.0, 0.2, 1.0);\n  \n  \u002F* Expressive tokenized motion (new in M3 Expressive) *\u002F\n  --md-sys-motion-expressive-fast-spatial: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-expressive-fast-effects: cubic-bezier(0.2, 0.0, 0, 1.0);\n  --md-sys-motion-expressive-slow-spatial: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-expressive-slow-effects: cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n```\n\n## Checklist for Motion Implementation\n\nWhen implementing M3 motion, ensure:\n\n- [ ] Spring-based physics easing is used (not linear or ease-in-out)\n- [ ] Expressive vs standard motion modes are chosen appropriately per context\n- [ ] Durations match element size and complexity\n- [ ] Reduced motion preferences are respected\n- [ ] Only transform and opacity are animated (when possible)\n- [ ] Hover, focus, and press states have appropriate feedback\n- [ ] Page transitions feel smooth and coherent\n- [ ] Motion serves a functional purpose\n- [ ] Stagger animations are used for lists\n- [ ] All animations are tested on mobile devices\n- [ ] Motion tokens are defined and used consistently (including expressive tokens)\n- [ ] Container transforms are used for view transitions\n- [ ] Ripple effects are implemented for touch targets\n- [ ] Haptic feedback is coordinated with spring animations where appropriate\n- [ ] Shape morphing animations use expressive easing\n\n## Resources\n\n- `examples\u002Fmotion-patterns.css` — Ready-to-use CSS animation patterns using M3 motion tokens (fade, scale, slide, shared axis, state layer, elevation, and theme transitions). Copy the relevant @keyframes and classes into your project.\n- M3 motion overview: https:\u002F\u002Fm3.material.io\u002Fstyles\u002Fmotion\u002Foverview\n- Material Design Tokens (motion): https:\u002F\u002Fgithub.com\u002Fmaterial-foundation\u002Fmaterial-tokens\n","# Material Design 3 Motion and Animation\n\n## Overview\n\nThis skill guides the implementation of Material Design 3 (M3) Expressive motion principles to create springy, natural-feeling animations that enhance usability and delight users.\n\n**Keywords**: Material Design 3, M3, motion, animation, transitions, micro-interactions, easing, duration, spring physics, expressive motion, haptics, physics-based animation\n\n## Core Principles\n\n### Expressive Motion Philosophy\n\nM3 Expressive motion is designed to feel alive, natural, and responsive:\n\n1. **Physics-Based Springs**: Use spring-based animations governed by stiffness, damping, and velocity — replacing traditional cubic-bezier easing for more natural, lively motion\n2. **Purposeful Motion**: Every animation should serve a purpose—guiding attention, providing feedback, or showing relationships\n3. **Responsive Feel**: Motion responds to user input with appropriate speed and timing\n4. **Spatial Coherence**: Elements move in ways that respect spatial relationships and physics\n5. **Haptic Integration**: Pair spring animations with platform-native haptic feedback for tactile reinforcement\n\n### Motion Modes\n\n**Expressive Motion** (Default for M3 Expressive):\n- Overshoots, bounces, and adds energy\n- Ideal for touch interactions and hero moments\n- Creates a playful, emotionally resonant feel\n- Uses higher spring energy and pronounced bounce\n\n**Standard Motion** (Utilitarian flows):\n- Restrained, minimal bounce\n- Better for productivity-focused or system-critical flows\n- Natural feel without excess playfulness\n\n**Legacy Motion** (Compatibility):\n- Traditional easing for backwards compatibility\n- Use only when spring physics cannot be applied\n\n### Spring Physics Parameters\n\nM3 Expressive motion uses three key physics parameters instead of traditional time\u002Feasing curves:\n\n1. **Stiffness**: Controls how \"hard\" the spring is — higher stiffness means the animation finishes more quickly\n2. **Damping**: Determines how quickly the bounce fades out — a damping value of 1 eliminates bounce completely\n3. **Initial Velocity**: Sets the initial speed, influencing overall timing and feel\n\n| Scheme     | Stiffness | Damping | Bounce Effect |\n|------------|-----------|---------|---------------|\n| Expressive | High      | Medium  | Pronounced overshoot |\n| Standard   | Medium    | High    | Minimal\u002Fnone |\n\n## Animation Types\n\n### 1. Transitions\n\n**Enter Transitions** (Elements appearing):\n- Fade + Scale: Elements fade in while scaling from 80% to 100%\n- Fade + Slide: Elements slide in from edge while fading\n- Container Transform: Morphing one container into another\n\n**Exit Transitions** (Elements disappearing):\n- Fade + Scale: Elements scale down to 80% while fading out\n- Fade + Slide: Elements slide away while fading\n- Keep exits faster than enters (maintain forward momentum)\n\n**Shared Element Transitions** (Between screens\u002Fstates):\n- Morph containers smoothly between views\n- Maintain visual continuity\n- Use container transform pattern\n\n### 2. Micro-interactions\n\n**Hover States**:\n- Subtle elevation change (add shadow)\n- Color shift using state layer\n- Scale slightly (1.02x-1.05x)\n- Duration: 100-200ms\n\n**Focus States**:\n- Outline or ring animation\n- Scale or elevation change\n- Duration: 200-300ms\n\n**Press\u002FTouch States**:\n- Ripple effect from touch point\n- Scale down slightly (0.98x)\n- State layer with opacity\n- Duration: 100-150ms\n\n**Loading States**:\n- Shimmer or skeleton screens\n- Circular progress indicators\n- Linear progress bars\n- Continuous, smooth motion\n\n### 3. Complex Animations\n\n**Stagger Animations**:\n- Animate list items with incremental delay\n- Delay between items: 30-50ms\n- Creates cascade effect\n\n**Choreographed Animations**:\n- Multiple elements moving in coordination\n- Use animation-delay for orchestration\n- Maintain spatial relationships\n\n**Morphing Shapes**:\n- Smooth path interpolation between shapes\n- Variable corner radius transitions\n- Use for state changes and transformations\n\n## Duration Guidelines\n\n### Standard Durations\n\n**Extra Small** (50-100ms):\n- Icon state changes\n- Tooltip appearances\n- Simple opacity changes\n\n**Small** (100-200ms):\n- Button hover states\n- Simple scale animations\n- Color transitions\n\n**Medium** (200-300ms):\n- Modal dialogs\n- Navigation transitions\n- Card expansions\n\n**Large** (300-500ms):\n- Page transitions\n- Complex transformations\n- Sheet presentations\n\n**Extra Large** (500ms+):\n- Major state changes\n- Full screen transitions\n- Use sparingly\n\n### Context-Based Adjustments\n\n- **Mobile**: Slightly faster (0.8x-0.9x of base duration)\n- **Desktop**: Standard durations\n- **Reduced Motion**: Reduce to 10-20% of standard duration or disable\n- **Large Elements**: Increase duration proportionally\n\n## Spring Physics Implementation\n\n### Expressive Spring (Default for M3 Expressive)\n\n```css\n\u002F* CSS with expressive spring-like bezier approximation *\u002F\ntransition-timing-function: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n\n\u002F* Enhanced linear() for expressive spring with overshoot *\u002F\ntransition-timing-function: linear(\n  0, 0.004, 0.016 2.5%, 0.063 5%, 0.141, 0.25, \n  0.391 11.3%, 0.563, 0.765, 1.000 20%, 1.066 23.8%, \n  1.109 27.5%, 1.130 31.3%, 1.138 35%, 1.136 38.8%, \n  1.121 46.3%, 1.093 53.8%, 1.057 61.3%, 1.025 68.8%, \n  1.005 77.5%, 0.997 87.5%, 1\n);\n```\n\n### Standard Spring\n\n```css\n\u002F* CSS with standard spring-like bezier approximation *\u002F\ntransition-timing-function: cubic-bezier(0.2, 0.0, 0, 1.0);\n\n\u002F* CSS linear() for better standard spring approximation *\u002F\ntransition-timing-function: linear(\n  0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, \n  0.938 16.7%, 1.017, 1.077, 1.121, 1.149 24.3%, \n  1.159, 1.163, 1.161, 1.154 29.9%, 1.129 32.8%, \n  1.051 39.6%, 1.017 43.1%, 0.991, 0.977 51%, \n  0.974 53.8%, 0.975 57.1%, 0.997 69.8%, 1.003 76.9%, 1\n);\n```\n\n### JavaScript (Web Animations API)\n\n```javascript\n\u002F\u002F Expressive spring animation\nelement.animate(\n  [\n    { transform: 'scale(0)', opacity: 0 },\n    { transform: 'scale(1)', opacity: 1 }\n  ],\n  {\n    duration: 300,\n    easing: 'cubic-bezier(0.05, 0.7, 0.1, 1.0)',\n    fill: 'forwards'\n  }\n);\n\n\u002F\u002F Standard spring animation\nelement.animate(\n  [\n    { transform: 'translateY(20px)', opacity: 0 },\n    { transform: 'translateY(0)', opacity: 1 }\n  ],\n  {\n    duration: 250,\n    easing: 'cubic-bezier(0.2, 0.0, 0, 1.0)',\n    fill: 'forwards'\n  }\n);\n```\n\n### Choosing Expressive vs Standard Motion\n\n| Scenario | Motion Mode | Why |\n|----------|-------------|-----|\n| Button press feedback | Expressive | User-triggered, benefits from bounce |\n| Page transition | Standard | Functional, should not distract |\n| Loading completion | Expressive | Celebratory moment of delight |\n| Form validation | Standard | Utilitarian feedback |\n| FAB expansion | Expressive | Key interaction with visual emphasis |\n| List scroll | Standard | Continuous motion, should be smooth |\n| Shape morphing | Expressive | Visual storytelling moment |\n| Tooltip appearance | Standard | Informational, should not distract |\n\n## Haptics Integration\n\nM3 Expressive recommends pairing spring-driven animations with platform-native haptic feedback:\n\n### Principles\n\n1. **Coordinate with Motion**: Haptic effects should fire at the key moment of the animation (e.g., at the point of overshoot or completion)\n2. **Match Intensity**: Gentle haptics for subtle interactions, stronger for significant state changes\n3. **Platform-Native**: Use the platform's haptic engine for the most natural feel\n4. **Respect Preferences**: Honor user haptic settings and provide accessibility options\n\n### Web Implementation\n\n```javascript\n\u002F\u002F Pair haptic feedback with expressive motion\nfunction expressivePress(element) {\n  \u002F\u002F Trigger haptic feedback\n  if (navigator.vibrate) {\n    navigator.vibrate(10); \u002F\u002F Short, subtle haptic\n  }\n  \n  \u002F\u002F Trigger spring animation\n  element.animate([\n    { transform: 'scale(1)' },\n    { transform: 'scale(0.95)' },\n    { transform: 'scale(1.02)' },\n    { transform: 'scale(1)' }\n  ], {\n    duration: 300,\n    easing: 'cubic-bezier(0.05, 0.7, 0.1, 1.0)'\n  });\n}\n```\n\n## Implementation Patterns\n\n### Container Transform\n\nSmoothly morph from one container to another:\n\n```javascript\n\u002F\u002F Using View Transitions API (modern browsers)\ndocument.startViewTransition(() => {\n  \u002F\u002F Update DOM\n  container.classList.toggle('expanded');\n});\n\n\u002F\u002F CSS\n::view-transition-old(container),\n::view-transition-new(container) {\n  animation-duration: 300ms;\n  animation-timing-function: cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n```\n\n### Shared Axis Transition\n\nElements exit and enter along a shared axis:\n\n```css\n\u002F* X-axis shared transition *\u002F\n.exit-left {\n  animation: exit-left 300ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n.enter-right {\n  animation: enter-right 300ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n@keyframes exit-left {\n  from { transform: translateX(0); opacity: 1; }\n  to { transform: translateX(-100px); opacity: 0; }\n}\n\n@keyframes enter-right {\n  from { transform: translateX(100px); opacity: 0; }\n  to { transform: translateX(0); opacity: 1; }\n}\n```\n\n### Elevation Change\n\nAnimate elevation with shadow and transform:\n\n```css\n.elevated-card {\n  transition: \n    box-shadow 200ms cubic-bezier(0.2, 0.0, 0, 1.0),\n    transform 200ms cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n\n.elevated-card:hover {\n  box-shadow: \n    0px 4px 8px rgba(0, 0, 0, 0.12),\n    0px 8px 16px rgba(0, 0, 0, 0.08);\n  transform: translateY(-2px);\n}\n```\n\n### Ripple Effect\n\nMaterial ripple for touch feedback:\n\n```css\n.ripple {\n  position: relative;\n  overflow: hidden;\n}\n\n.ripple::after {\n  content: '';\n  position: absolute;\n  top: 50%;\n  left: 50%;\n  width: 0;\n  height: 0;\n  border-radius: 50%;\n  background: rgba(255, 255, 255, 0.5);\n  transform: translate(-50%, -50%);\n  transition: width 0.3s, height 0.3s;\n}\n\n.ripple:active::after {\n  width: 300%;\n  height: 300%;\n}\n```\n\n## Best Practices\n\n### Do's\n\n1. ✅ Use spring physics for natural motion\n2. ✅ Match animation duration to element size (larger = longer)\n3. ✅ Provide immediate feedback for user interactions\n4. ✅ Use motion to show relationships between elements\n5. ✅ Test animations on lower-end devices\n6. ✅ Respect prefers-reduced-motion setting\n7. ✅ Use stagger animations to make large datasets feel lighter\n8. ✅ Keep motion purposeful and functional\n\n### Don'ts\n\n1. ❌ Don't use linear easing (feels mechanical)\n2. ❌ Don't animate too many properties simultaneously\n3. ❌ Don't make animations too slow (feels sluggish)\n4. ❌ Don't ignore accessibility preferences\n5. ❌ Don't use motion purely for decoration\n6. ❌ Don't animate layout properties excessively (causes reflow)\n7. ❌ Don't use different easing curves randomly\n\n## Accessibility\n\n### Reduced Motion\n\nAlways respect user preferences:\n\n```css\n@media (prefers-reduced-motion: reduce) {\n  * {\n    animation-duration: 0.01ms !important;\n    animation-iteration-count: 1 !important;\n    transition-duration: 0.01ms !important;\n  }\n}\n```\n\n### Focus Indicators\n\nEnsure animated focus states are still visible:\n- Maintain adequate contrast\n- Don't rely solely on motion for focus indication\n- Use both color and shape changes\n\n### Performance\n\n- Prefer `transform` and `opacity` (GPU accelerated)\n- Avoid animating `width`, `height`, `top`, `left` (causes layout reflow)\n- Use `will-change` sparingly for complex animations\n- Test on mobile devices and low-end hardware\n\n## Motion Tokens\n\nDefine motion tokens for consistency. M3 Expressive introduces tokenized spring-based motion:\n\n```css\n:root {\n  \u002F* Durations *\u002F\n  --md-sys-motion-duration-short1: 50ms;\n  --md-sys-motion-duration-short2: 100ms;\n  --md-sys-motion-duration-short3: 150ms;\n  --md-sys-motion-duration-short4: 200ms;\n  --md-sys-motion-duration-medium1: 250ms;\n  --md-sys-motion-duration-medium2: 300ms;\n  --md-sys-motion-duration-medium3: 350ms;\n  --md-sys-motion-duration-medium4: 400ms;\n  --md-sys-motion-duration-long1: 450ms;\n  --md-sys-motion-duration-long2: 500ms;\n  --md-sys-motion-duration-long3: 550ms;\n  --md-sys-motion-duration-long4: 600ms;\n  \n  \u002F* Easing — Standard (utilitarian) *\u002F\n  --md-sys-motion-easing-standard: cubic-bezier(0.2, 0.0, 0, 1.0);\n  --md-sys-motion-easing-standard-decelerate: cubic-bezier(0.0, 0.0, 0, 1.0);\n  --md-sys-motion-easing-standard-accelerate: cubic-bezier(0.3, 0.0, 1.0, 1.0);\n  \n  \u002F* Easing — Expressive (default for M3 Expressive) *\u002F\n  --md-sys-motion-easing-expressive: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-expressive-decelerate: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-expressive-accelerate: cubic-bezier(0.3, 0.0, 0.8, 0.15);\n  \n  \u002F* Easing — Emphasized (legacy naming, same as expressive) *\u002F\n  --md-sys-motion-easing-emphasized: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-emphasized-decelerate: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-easing-emphasized-accelerate: cubic-bezier(0.3, 0.0, 0.8, 0.15);\n  \n  \u002F* Legacy easing *\u002F\n  --md-sys-motion-easing-legacy: cubic-bezier(0.4, 0.0, 0.2, 1.0);\n  \n  \u002F* Expressive tokenized motion (new in M3 Expressive) *\u002F\n  --md-sys-motion-expressive-fast-spatial: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-expressive-fast-effects: cubic-bezier(0.2, 0.0, 0, 1.0);\n  --md-sys-motion-expressive-slow-spatial: cubic-bezier(0.05, 0.7, 0.1, 1.0);\n  --md-sys-motion-expressive-slow-effects: cubic-bezier(0.2, 0.0, 0, 1.0);\n}\n```\n\n## Checklist for Motion Implementation\n\nWhen implementing M3 motion, ensure:\n\n- [ ] Spring-based physics easing is used (not linear or ease-in-out)\n- [ ] Expressive vs standard motion modes are chosen appropriately per context\n- [ ] Durations match element size and complexity\n- [ ] Reduced motion preferences are respected\n- [ ] Only transform and opacity are animated (when possible)\n- [ ] Hover, focus, and press states have appropriate feedback\n- [ ] Page transitions feel smooth and coherent\n- [ ] Motion serves a functional purpose\n- [ ] Stagger animations are used for lists\n- [ ] All animations are tested on mobile devices\n- [ ] Motion tokens are defined and used consistently (including expressive tokens)\n- [ ] Container transforms are used for view transitions\n- [ ] Ripple effects are implemented for touch targets\n- [ ] Haptic feedback is coordinated with spring animations where appropriate\n- [ ] Shape morphing animations use expressive easing\n\n## Resources\n\n- `examples\u002Fmotion-patterns.css` — Ready-to-use CSS animation patterns using M3 motion tokens (fade, scale, slide, shared axis, state layer, elevation, and theme transitions). Copy the relevant @keyframes and classes into your project.\n- M3 motion overview: https:\u002F\u002Fm3.material.io\u002Fstyles\u002Fmotion\u002Foverview\n- Material Design Tokens (motion): https:\u002F\u002Fgithub.com\u002Fmaterial-foundation\u002Fmaterial-tokens\n",{"name":5,"license":14,"description":7},"master","ee4668daab05d977b529036c0b1711dc09f997e0",".claude\u002Fskills\u002Fmaterial-design-3-motion","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5","https:\u002F\u002Fgithub.com\u002Fpohlai88","2026-09-05 22:56:19",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add pohlai88\u002Fafenda-xforge-v5 --skill material-design-3-motion",{"tool":35,"command":36},"bunx","bunx skills add pohlai88\u002Fafenda-xforge-v5 --skill material-design-3-motion",{"tool":38,"command":39},"pnpm","pnpm dlx skills add pohlai88\u002Fafenda-xforge-v5 --skill material-design-3-motion","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmaterial-design-3-motion\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"examples\u002Fmotion-patterns.css","OTHER","其他",6079,"https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmaterial-design-3-motion\u002Fexamples\u002Fmotion-patterns.css",[50,58,65,72,79,86],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":54,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7C4FZM0ZBB1P5GV1EZJJCCT","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","MIT","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fvercel-react-best-practices\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":54,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7C4F67V83B35BDPW73AQNWR","turborepo","Turborepo monorepo build system and orchestration. Covers task pipelines, dependsOn syntax, caching configuration, remote cache, filtering, CI optimization, environment variables, workspace management, watch mode, package boundaries, and code generation.\n\nUse when configuring tasks, creating packages, setting up monorepo, sharing code between apps, running changed packages, debugging cache, optimizing CI, resolving workspace dependencies, enforcing package boundaries, or generating code.","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fturborepo\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":54,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M7C4ET5ETKW3FFB4SFFPNQWG","tailwind","Tailwind CSS v4 patterns and design systems. Use when configuring Tailwind themes, building components, implementing dark mode, using container queries, migrating from v3, integrating shadcn\u002Fui, or fixing build errors. Use for tailwind, css, styling, theme, design-tokens.","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Ftailwind\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":54,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M7C4DESY6RA5XWDNVV155THK","pnpm-workspace","pnpm workspace monorepo management with filtering, catalogs, and shared configs. Use when setting up monorepos, managing workspace dependencies, filtering package commands, or sharing configuration across packages.","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fpnpm-workspace\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7C4CZ3VMTYQQJXVJXGY3M0X","material-theme-builder","Generate Material Design 3 color themes programmatically from a source color using @material\u002Fmaterial-color-utilities, the same engine that powers the Material Theme Builder. Use this when the user asks to generate an M3 color palette, create a custom theme from a brand color, or export M3 tokens to CSS, JSON, or framework configs.","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmaterial-theme-builder\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M7C4CT86QFTT2N0PJCPTG5RB","material-design-3-typography","Applies Material Design 3 Expressive typography principles including variable fonts, type scales, and hierarchy. Use this when working on text styling, type hierarchy, readable interfaces, or when the user asks to apply Material Design 3 typography guidelines.","https:\u002F\u002Fgithub.com\u002Fpohlai88\u002Fafenda-xforge-v5\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fmaterial-design-3-typography\u002FSKILL.md",[],[]]