Changelog

Added

• drag: Drag gesture added to JavaScript API.

Fixed

• AnimatePresence: Fire onExitComplete after exiting children unmount.
• AnimatePresence: popLayout children that don't accept ref are now popped when root component is <motion> element.
• Fix interpolation of axis rotate and skew transforms during shared layout animation.
• Fix layout animations when layout is enabled after mount.
• Fix drag jumping to 0 after animate x/y to CSS variable.
• arc: Fix path animations with animate.
• Ensure shared elements are freed from memory when unmounted.
• Fix accelerated independent transform animations vanishing when they start from a float residue.

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.

Fixed

• Fix velocity hand-off for hardware-accelerated springs.
• cubicBezier: More accurate, 2x faster.
• Reorder: Fix click events on reoredered items.
• useTransform: Fix desync when source is set in an effect under Strict Mode.

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.

Changed

• Removed internal APIs restored in 13.5.1 for compatibility with framer-motion 13.0–13.4. Future removed internal APIs won't cause cross-compatibility issues since pinning internal framer-motion, motion-dom and motion-utils dependencies.

Changed

• <motion>: Fall back to the attribute in readSVGValue when computed style is empty.
• <motion>: Internal changes to animateChanges for size reductions.

Fixed

• scroll: Temporarily reverted removal of internal observeTimeline API to fix compatibility with previous 13.x APIs. Moving to pinned dependencies before removing in 14.x.
• styleEffect: Cleaning up an earlier value no longer removes a value that was bound to the same key after it.
• svgEffect: No longer writes transforms and origins as attributes.
• <motion>: inherit={false} now correctly not inheriting parent animations.
• <motion>: Fix sortNodePosition throwing when a sibling hasn't mounted

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.

Changed

• scroll/useScroll: More offsets are now hardware accelerated via ViewTimeline.

Fixed

• animate: Reduced size of Motion Studio introspection call.
• useTransform: Accelerated values now correctly clamp.
• scroll/useScroll: Ensure offsets work the same across the JS main thread and ViewTimeline.
• scroll/useScroll: Remove ScrollTimeline/ViewTimeline observer in favour of main-thread scroll tracking.

Fixed

• AnimatePresence: mode="wait" no longer drops new children if exit completes during a React transition.

Fixed

• layout: Fix relative child jumping when parent interrupts layout animation.
• AnimatePresence: Can no longer drop a child added while another exit animation completes.
• Reorder: Only clear Reorder.Group's reorder guard when values change.
• spring/useSpring: 5% smaller.

Changed

• scroll: 44% smaller.
• useScroll: 33% smaller.
• Scroll callbacks: 50% faster.
• Removed ScrollTimeline support for JS callbacks as benchmarked no improvement over scrollInfo.

Fixed

• useDragControls: Fixed snapToCursor origin drift on repeated calls.
• drag: Improved pointerend timing.
• spring: Check invalid spring values before applying.
• AnimatePresence: Ensure children don't stick during reentry.

Fixed

• <motion>: Ensure animations replay when Suspense reveals memoized content.

Fixed

• Reorder: Don't scale position of elements at origin 0 when dragConstraints changes.
• Unrecognised easing names no longer throw.

Fixed

• animate: CSS variable writes on SVGs apply to style attribute.

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.

Fixed

• Guard animation window access in non-browser runtimes.
• AnimatePresence: Improved compat with React 19 strict mode.

Added

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

Changed

• Removed optional @emotion/is-prop-valid dependency in favour of explicit <MotionConfig isValidProp={isPropValid}>.

Fixed

• Hardware-accelerated SVG elements correctly apply final style on animation complete.
• AnimatePresence: Ensure nodes are marked as safe to remove when rendering propagate with no motion children.

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.