Changelog

Added

• Support for repeatType and repeatDelay in animation sequences.

Fixed

• Variants: Re-run keyframe animations when switching between variant labels even when they share identical keyframe arrays.
• Drag: Preserve in-flight motion value animations across React 19 reorder unmount/remount so dragSnapToOrigin no longer leaves the drag transform stranded after a layout swap.
• LazyMotion: Share React contexts between the framer-motion and framer-motion/m (and therefore motion/react and motion/react-m) CJS bundles so that <m.div> from the /m subpath picks up features loaded by <LazyMotion> from the main entry point.
• useScroll: Support hydrating target and container refs from anywhere in the tree.
• Drag: Gesture no longer starts from incorrect start point when rendered inside <AnimatePresence initial={false} />.
• Drag: dragConstraints, when set as viewport-relative ref, no longer break on scroll.§
• Updated visualElement hydration order.
• useAnimate: Now respects skipAnimations.
• AnimatePresence: Fix object-form initial values not applied on re-entry after exit completes.
• scroll: Fixed callback progress when tracking an element.
• useScroll: Fix hardware acceleration when tracking an element.

Added

• Added layoutAnchor prop to configure custom anchor point for resolving relative projection boxes.

Fixed

• Reorder: Fix axis switching after window resize.
• Reorder: Fix with virtualised lists.
• AnimatePresence: Ensure children are removed when exit animation matches current values.

Added

• Support for hardware accelerating "start" and "end" offsets in scroll and useScroll.
• Support for oklch, oklab, lab, lch, color, color-mix, light-dark color types.

Fixed

• Fix whileInView with client-side navigation.
• Fix draggable elements when layout updates due to surrounding element re-renders.
• Improved memory pressure of layout animations.
• Ensure motion value returned from useSpring reports correct isAnimating().

Added

• Allow dragSnapToOrigin to accept "x" or "y" for per-axis snapping.
• Added axis-locked layout animations with layout="x" and layout="y".
• Added skipInitialAnimation to useSpring.

Fixed

• Fixed height and width: auto animations with box-sizing: border-box.
• Reset component values when exit animation finishes.
• Ensure anticipate easing returns 1 at p === 1.
• Fix @emotion/is-prop-valid resolve error in Storybook.
• Remove data-pop-layout-id from exiting elements when animation interrupted.
• Ensure we skip WAAPI for non-animatable keyframes.
• Ensure we skip WAAPI for SVG transforms.
• Ensure MotionValue props are not passed to SVG.
• AnimatePresence: Prevent mode="wait" elements from getting stuck when switched rapidly.

Fixed

• Reduced filesize of styleEffect.
• Fix rounding from popLayout.
• opacity animations in React Strict Mode in development.
• Ensure useSpring is not affected by monitor framerate.
• Updating animations sequence segment types to exclude lifecycle handlers.
• Fix layout animations with parents offset by a %-based translation.
• Fix autoplay: false with WAAPI animations.
• Fix layout jump in React Strict Mode in development.
• Detect divide-by-zero in CSS calc() values before making animatable templates.

Fixed

• Fixing combination of string keyframes, spring and delay.
• Gracefully handle negative scroll values.
• Fix one-frame visual gap when rapidly switching WAAPI animations.
• animation.time = 0 on a finished animation sets the playhead in a paused state.

Added

• ViewTimeline support for scroll and useScroll.

Fixed

• Handle % translate values in layout animations.

Fixed

• Ensure final WAAPI styles are always committed synchronously to prevent flash of incorrect styles in Firefox.
• Prevent Next.js from caching typeof window checks.
• Improve projection node cleanup.
• Variant propagation fixed for asynchronously-mounted children.

Fixed

• Ensure onComplete fires at the end of an animation sequence.

Fixed

• Ensure velocity is never transferred to a time-derived spring.

Fixed

• Layout animations: Reset motion value velocity when starting a new layout animation.

Fixed

• useScroll: Ensure animations aren't hardware accelerated when target is set.
• Improve animatable "none" generation for mask values.

Added

• useScroll: Hardware accelerated animations.

Fixed

• Improve detection of detached elements with vanilla layout animations.

Fixed

• AnimatePresence: Ensure exiting nodes are correctly removed when rapidly switching children.

Added

• <motion />: New propagate.tap prop prevents tap gestures from propagating to parents.

Added

• transition.inherit: When true, inherit transition values from less-specific transitions.

Fixed

• <motion />: Ensure animation state is reset after being re-suspended.
• Prevent stale values when mixing transitionEnd and transition.type: false.
• Drag: Fix "sticky" throw velocity on initial interaciton.
• Drag: Ensure catching a thrown element kills its velocity.

Fixed

• onHoverStart and onHoverEnd first argument now correctly typed as PointerEvent.
• whileHover: No longer persists after drag end.
• AnimatePresence: Allow changing mode prop.

Added

• Drag constraints updated even when draggable or constraints resize outside of React renders.

Added

• animate: Support for bi-directional callbacks within animation sequences.

Fixed

• Ensure onPan never fires before onPanStart.

Fixed

• Allow drag to be initiated by child a and button elements.

Added

• MotionConfig: Add skipAnimations option.

Fixed

• animate: Prevent error when calling stop() on removed elements.
• animateLayout: Fixing shared element animations when animate called before animateLayout.

Fixed

• Reorder: Fixed viewport autoscroll.

Fixed

• Updates to layout animations.

Fixed

• useAnimate: Now respects reduced motion settings set via MotionConfig.

Added

• transformViewBoxPoint: Scale drag gestures within <svg> elements where viewBox and rendered width/height are mismatched.
• trackContentSize: New scroll and useScroll option for tracking changes to content size.

Fixed

• Add React 19 test suite to CI.
• Fix types with motion.create().
• Shared element animations now respect layoutDependency.

Added

• Add default value type px for fontSize.

Fixed

• Removed default value type from radius.
• Ensure LazyMotion animates initial state even when state has changed before Motion is loaded.

Fixed

• Ensure scale: "0%" isn't treated as default value.