motion-design-patterns
Framer Motion (Motion) animation patterns for React — springs, staggers, layout animations, micro-interactions, scroll effects, and page transitions. Use when building or improving UI animations, adding polish, or making interfaces feel premium.
dylanfeltus · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add dylanfeltus/skills --skill motion-design-patternsAbout this skill
name: motion-design-patterns description: Framer Motion (Motion) animation patterns for React — springs, staggers, layout animations, micro-interactions, scroll effects, and page transitions. Use when building or improving UI animations, adding polish, or making interfaces feel premium.
Motion Design Patterns
Framer Motion (Motion) patterns for React — springs, staggers, layout animations, micro-interactions, scroll-triggered effects, and exit animations. The #1 differentiator between generic and polished UI.
When to Use
- Building or improving UI animations in a React project
- User asks for "polish", "delight", "micro-interactions", or "make it feel good"
- Adding entrance/exit animations, hover effects, or page transitions
- Making lists, cards, modals, or navigation feel premium
- User references Magic UI, Motion Primitives, or Framer Motion
Core Philosophy
- Motion should be purposeful. Every animation should communicate something — state change, hierarchy, spatial relationship, or feedback.
- Less is more. One well-tuned spring beats five competing animations.
- Performance first. Animate
transformandopacityonly. Never animatewidth,height,top,left, ormargin. - Consistency matters. Use the same spring configs throughout a project.
Dependencies
npm install motion
Import: import { motion, AnimatePresence, stagger, useScroll, useTransform } from "motion/react"
Note: The package was renamed from framer-motion to motion in late 2024. Both work, but motion is the current package.
Spring Configurations
Springs feel more natural than easing curves. Use these as your defaults:
Recommended Defaults
// Snappy — buttons, toggles, small elements
const snappy = { type: "spring", stiffness: 500, damping: 30 }
// Smooth — cards, panels, modals
const smooth = { type: "spring", stiffness: 300, damping: 25 }
// Gentle — page transitions, large elements
const gentle = { type: "spring", stiffness: 200, damping: 20 }
// Bouncy — playful UI, notifications, badges
const bouncy = { type: "spring", stiffness: 400, damping: 15 }
Quick Reference
| Feel | stiffness | damping | Use for |
|---|---|---|---|
| Snappy | 500 | 30 | Buttons, toggles, chips |
| Smooth | 300 | 25 | Cards, panels, modals |
| Gentle | 200 | 20 | Page transitions, heroes |
| Bouncy | 400 | 15 | Notifications, badges, fun UI |
Rules of Thumb
- Higher stiffness = faster animation
- Lower damping = more bounce
- damping ratio < 1 = will overshoot (bounce)
- For no bounce, set damping ≥ 2 × √stiffness
Pattern 1: Fade + Rise Entrance
The bread-and-butter entrance animation. Element fades in while sliding up slightly.
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ type: "spring", stiffness: 300, damping: 25 }}
>
Content here
</motion.div>
When to use: Cards, sections, any content appearing on the page.
Anti-pattern: Don't use y: 100 or large values — subtle (12–24px) feels premium, large feels janky.
Pattern 2: Staggered List
Children animate in one after another. The cascade effect that makes lists feel alive.
const container = {
hidden: { opacity: 0 },
visible: {
opacity: 1,
transition: {
staggerChildren: 0.08,
delayChildren: 0.1,
},
},
}
const item = {
hidden: { opacity: 0, y: 16 },
visible: {
opacity: 1,
y: 0,
transition: { type: "spring", stiffness: 300, damping: 25 },
},
}
<motion.ul variants={container} initial="hidden" animate="visible">
{items.map((i) => (
<motion.li key={i.id} variants={item}>
{i.content}
</motion.li>
))}
</motion.ul>
Timing guide:
- 3–5 items:
staggerChildren: 0.1 - 6–12 items:
staggerChildren: 0.06 - 12+ items:
staggerChildren: 0.03(or animate as a group)
Anti-pattern: Don't stagger more than ~15 items individually — it feels slow. Group them or use a wave effect.
Pattern 3: Layout Animations
Automatically animate between layout states. Motion's killer feature.
<motion.div layout transition={{ type: "spring", stiffness: 300, damping: 25 }}>
{isExpanded ? <ExpandedContent /> : <CollapsedContent />}
</motion.div>
Shared Layout (Tabs, Active Indicators)
{tabs.map((tab) => (
<button key={tab.id} onClick={() => setActive(tab.id)}>
{tab.label}
{active === tab.id && (
<motion.div
layoutId="activeTab"
className="absolute inset-0 bg-primary rounded-md"
transition={{ type: "spring", stiffness: 400, damping: 30 }}
/>
)}
</button>
))}
When to use: Tab indicators, expanding cards, reordering lists, filtering grids.
Performance tip: Add layout="position" if you only need to animate position (not size). It's cheaper.
Pattern 4: Exit Animations (AnimatePresence)
Elements animate out before being removed from the DOM.
<AnimatePresence mode="wait">
{isVisible && (
<motion.div
key="modal"
initial={{ opacity: 0, scale: 0.95 }}
animate={{ opacity: 1, scale: 1 }}
exit={{ opacity: 0, scale: 0.95 }}
transition={{ type: "spring", stiffness: 300, damping: 25 }}
>
Modal content
</motion.div>
)}
</AnimatePresence>
AnimatePresence modes
| Mode | Behavior | Use for |
|---|---|---|
"sync" (default) | Enter and exit at the same time | Crossfade effects |
"wait" | Wait for exit to finish before entering | Page transitions, modals |
"popLayout" | Exiting element pops out of layout flow | Lists where items are removed |
Pattern 5: Hover & Tap Micro-interactions
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.98 }}
transition={{ type: "spring", stiffness: 500, damping: 30 }}
>
Click me
</motion.button>
Hover Patterns by Element Type
| Eleme
Read the complete source ↗