--- name: framer-motion description: | Framer Motion animation library for React. Declarative, physics-based and gesture-aware: variants and orchestration, AnimatePresence, FLIP layout animation, scroll-linked motion, spring configuration and gestures. USE WHEN: user mentions "Framer Motion", "motion.div", "AnimatePresence", "variants", "layout animation", "spring animation", asks about animating a React component, exit animations, drag or gesture handling DO NOT USE FOR: timeline-based or non-React animation (use `gsap`), SVG-specific animation (use `svg-animation`), pure CSS effects (use `advanced-css-effects`) allowed-tools: Read, Grep, Glob, Write, Edit --- # Framer Motion Skill Animation library for React. Declarative, physics-based, gesture-aware. ## Install ```bash npm install framer-motion ``` ## Core API | API | Purpose | |-----|---------| | `motion.div` | Animatable element | | `animate` prop | Target state | | `initial` prop | Starting state | | `exit` prop | Unmount state (requires AnimatePresence) | | `variants` | Named animation states, enables orchestration | | `transition` | Timing, easing, spring config | | `whileHover / whileTap / whileFocus` | Gesture states | | `drag` | Drag gesture with constraints | | `layout / layoutId` | FLIP layout animation | | `AnimatePresence` | Animates unmounting components | | `useScroll` | Scroll progress values | | `useTransform` | Map one motion value to another | | `useSpring` | Spring-based motion value | | `useInView` | Observe element entering viewport | | `useAnimation` | Imperative animation control | ## Variants & Orchestration ```tsx const container = { hidden: {}, visible: { transition: { staggerChildren: 0.08, delayChildren: 0.1 } } }; const item = { hidden: { opacity: 0, y: 24 }, visible: { opacity: 1, y: 0, transition: { duration: 0.4, ease: "easeOut" } } }; {items.map(i => {i})} ``` ## AnimatePresence ```tsx {isVisible && ( )} ``` `mode="wait"` — exits finish before new element enters. `mode="popLayout"` — exiting element pops out of layout flow. ## Layout Animation (FLIP) ```tsx // Automatic smooth repositioning // Shared element transition across routes/conditions // source // destination — auto-animates ``` ## Scroll-linked ```tsx const { scrollYProgress } = useScroll({ target: ref, offset: ["start end", "end start"] }); const y = useTransform(scrollYProgress, [0, 1], [0, -100]); const opacity = useTransform(scrollYProgress, [0, 0.3, 1], [0, 1, 0]); ``` ## Spring Config ```ts // Bouncy entrance transition={{ type: "spring", stiffness: 400, damping: 20 } // Gentle transition={{ type: "spring", stiffness: 100, damping: 30 } // No bounce transition={{ type: "spring", stiffness: 300, damping: 50 } ``` ## Gestures ```tsx Click me // Drag with constraints ``` ## Imperative Control ```tsx const controls = useAnimation(); await controls.start({ opacity: 1, y: 0, transition: { duration: 0.4 } }); controls.stop(); ``` ## Reduced Motion ```tsx import { useReducedMotion } from "framer-motion"; function AnimatedCard() { const reduced = useReducedMotion(); return ( ); } ``` ## Common Patterns ```tsx // Stagger list reveal on scroll // Page transition wrapper // Accordion with layout animation // Drag-and-drop with layoutId // Hero → detail shared element ``` ## Pitfalls - `exit` only works inside `` — wrap the closest conditional parent - `layout` on elements that change children count can cause jumps — use `layoutId` instead - Spring animations ignore `duration` — use `stiffness`/`damping` - `useScroll` without `target` tracks window scroll - Always set `viewport={{ once: true }}` for entry animations to avoid re-triggering on scroll-up