Changelog

Added

• Reorder: Grab-and-move keyboard reordering.
• processFrame: Manually process the frameloop at t.
• stepFrames: For tests, synchronously advance frameloop time by duration.

Fixed

• Improved tree-shaking.
• motion: Fix layoutId elements jumping in some situations.
• Reorder: Make auto-scroll speed independent of refresh rate.
• drag: Fix animations when disabling drag from within onDrag.
• Fix shared layout animations applying an element's own scale/x/y twice.
• Fix replaying mount animation when an element takes over a layoutId.
• motion: Fix updating SVG styles.
• useTransform: Improving value resolution.

Changed

• MotionGlobalConfig.useManualTiming:

Added

• scopeMotion/useScopeMotion: Scope animations and gestures to set default transitions, specify root elements, match media, and easy cleanup.
• Reorder: Pass moved to onReorder as second argument.

Fixed

• drag: With direction lock, apply the move that sets the lock. Before, a fast drag released in that frame didn't move.
• press: Improve cleanup of keyboard accessibility events.
• Reorder: Stop double-counting window scroll during drag.
• motion: Ensure we animate from the latest props when parent Activity is made visible.
• useInView: Observe ref if contents change after mount.

Added

• drag: Drag gesture added to JavaScript API.

Added

• stagger: New grid, from: "edges" | "random" options.
• Support for scaleZ.

Fixed

• Fix matrix3d and other digit-named transform functions being tokenised as numbers.
• useSpring: Ensure when switching targets we animate to the new target on switch.
• Fix SVG MotionValue children being written as a children attribute.

Added

• Hardware accelerated independent transforms like x, y, scaleX etc.

Added

• animateLayout: Layout animations for vanilla JS.

Fixed

• Delay animation start when main thread held to prevent visual jumps.
• Fix whileHover/whileTap getting stuck after Fast Refresh reorders siblings.
• scroll/useScroll: Fix reporting of elastic overscroll.
• AnimatePresence: Fix popLayout when rendering into another window or iframe.
• animate: Fix JS animations jumping ahead when played after a pause at non-1 speed.
• Allow layout animations inside dragged elements.

Added

• spring: Now accepts negative bounce (0--1) to define overdamped springs.

Changed

• <m>: 20% smaller.
• useSpring: 10% smaller.
• scroll/useScroll: Use main thread for all offset animations.

Fixed

• Ensure warning and error messages are cleaned from production build.
• Ensure values are never rendered before they've been resolved.

Added

• AnimateView: View transitions for React 19.3, built on React's ViewTransition.

Added

• Hooks for Motion Editor.

Changed

• springValue/useSpring: 80% reduction in time when retargeting.
• animate: 10% smaller.
• animate: 20% reduction in startup time.
• animate: 10% reduction in per-frame JS.
• frame: Frame scheduling 10% faster.

Fixed

• animate: Fixed path drawing calculations.

Added

• animate.addEffect() for registering effects that lets animate drive non-DOM subjects alongside DOM elements.
• threeEffect (motion/three) supporting Three.js objects, materials, shader uniforms, TSL uniform nodes and more.
• vgpuEffect (motion/vgpu) supporting shared uniforms, Effect/Draw/Compute bindings ("params.time"), scene nodes, cameras, lights, materials, orbit controls, CSS colors and vector components.
• createEffect now accepts test, read and step options and exposes bound motion values via effect.get().

Changed

• Reduced filesize and improved performance of spring.
• MotionValueState no longer caches values in latest; effect renders read their motion values directly. set() drops its useDefaultValueType argument.

Added

• Reorder: Multidimensional reorder.
• Reorder: Automatic axis detection.
• Reorder: RTL support.

Added

• Hardware acceleration for backgroundColor in supported browsers.
• Hardware acceleration for SVG elements.

Fixed

• AnimatePresence: Exiting children no longer interleave with entering children, which could reorder and remount children present in both renders.
• motion: Throw error when passing a custom motion component an incorrect ref type.

Changed

• animateView: Layers are automatically grouped to match their DOM-hierarchy. New .group(false) method opts-out.

Fixed

• animateView: Auto-crop is now aspect-ratio aware, disabling crops for matching aspect-ratios.
• animateView: Disabled automatic border-radius animation.

Added

• animateView: Moves from Motion+ Early Access and alpha to main library.
• animateView: .add() resolves a CSS selector or Element to automatically generate, apply and remove view-transition-name.
• animateView: .new() and .old() configures values to animate on new and old layers.
• animateView: .layout() can set a custom transition on the size/position animation of the currently selected elements.
• animateView: Group layers now automatically crop with children set to cover, with border-radius animating from old radius to new. .crop(false) disables this behaviour.
• animateView: .class(name) tags currently selected elements with a view-transition-class as a custom CSS hook.

Fixed

• AnimatePresence: Prevent stuck exit animations when children interrupt.
• drag: Child e.stopPropagation() no longer break drag end.
• Fixing Next.js OOM on Windows when importing via motion package.
• animateLayout: Improve handling of parallel/interleaved calls.

Changed

• animateView: .enter() and .exit() now refer specifically to new and old layers where there are no matching old or new layers.
• animateView: Interrupted transition setups now return resolved animation rather than throwing.

Added

• path option to transition.
• arc() for motion along an arc.

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.

Added

• ViewTimeline support for scroll and useScroll.

Added

• useScroll: Hardware accelerated animations.

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.

Added

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

Fixed

• Ensure onPan never fires before onPanStart.

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.

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

• useFollowValue and followValue: useSpring-style motion values that can accept any transition.

Fixed

• Fix "multiple keyframe" error when using spring animations as default transitions for animation sequences.

Added

• Adding new exports for internal use.

Added

• Support for multiple output value maps with useTransform.

Added

• Support for auto-scrolling when a Reorder.Item reaches the edges of its parent scrollable container.