framer-motion
14.7.1 · 27 Oct 2026MIT45.3M / weekRepositoryHomepagenpmAtom feed
885 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 14.x · latest line
14.7.1
27 Oct 2026Demote transforms to CPU when interrupted by layout animations.
14.7.0
27 Oct 2026animate: Mutable timeline sequences.animate: Relative label offsets for timeline sequences.useScroll: ReturnsscrollXLengthandscrollYLength.
Added
animate: Mutable timeline sequences.animate: Relative label offsets for timeline sequences.useScroll: ReturnsscrollXLengthandscrollYLength.Reorder: AddLazyMotion-compatible import.motion:transition.outprop for transitions when exiting a state.
Fixed
Fix one flash when changing playback speed of accelerated independent transform.
AnimatePresence: Improved positioning of popped elements.spring: Fix overdamped springs snapping to target.drag: Ref-constraints kept up-to-date after scroll.motion: AnimatelayoutIdelements relative tolayoutRootcontainer.motion: Bundle size reductions.Moving
background-coloranimations back to main thread for improved interpolation.drag: Fix drag inertia stopping dead after a fast flick from a standstill.layout:layoutIdelements now animate relative to their closestlayoutRootancestor, if any.layout:layoutIdmay be changed after mount.useScroll: Fix tracking in horizontal containers.useSpring: Reduced bundle size by 30%.
14.6.0
22 Oct 2026Reorder: Grab-and-move keyboard reordering.processFrame: Manually process the frameloop att.stepFrames: For tests, synchronously advance frameloop time byduration.
Added
Reorder: Grab-and-move keyboard reordering.processFrame: Manually process the frameloop att.stepFrames: For tests, synchronously advance frameloop time byduration.
Fixed
Improved tree-shaking.
motion: FixlayoutIdelements jumping in some situations.Reorder: Make auto-scroll speed independent of refresh rate.drag: Fix animations when disablingdragfrom withinonDrag.Fix shared layout animations applying an element's own
scale/x/ytwice.Fix replaying mount animation when an element takes over a
layoutId.motion: Fix updating SVG styles.useTransform: Improving value resolution.
14.5.0
21 Oct 2026scopeMotion/useScopeMotion: Scope animations and gestures to set default transitions, specify root elements, match media, and easy cleanup.Reorder: PassmovedtoonReorderas second argument.drag: With direction lock, apply the move that sets the lock. Before, a fast drag released in that frame didn't move.
Added
scopeMotion/useScopeMotion: Scope animations and gestures to set default transitions, specify root elements, match media, and easy cleanup.Reorder: PassmovedtoonReorderas 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-countingwindowscroll during drag.motion: Ensure we animate from the latest props when parentActivityis made visible.useInView: Observerefif contents change after mount.
14.4.0
19 Oct 2026drag: Drag gesture added to JavaScript API.
14.3.1
19 Oct 2026AnimatePresence: FireonExitCompleteafter exiting children unmount.AnimatePresence:popLayoutchildren that don't acceptrefare now popped when root component is<motion>element.Fix interpolation of axis
rotateandskewtransforms during shared layout animation.
Fixed
AnimatePresence: FireonExitCompleteafter exiting children unmount.AnimatePresence:popLayoutchildren that don't acceptrefare now popped when root component is<motion>element.Fix interpolation of axis
rotateandskewtransforms during shared layout animation.Fix layout animations when
layoutis enabled after mount.Fix
dragjumping to0after animatex/yto CSS variable.arc: Fix path animations withanimate.Ensure shared elements are freed from memory when unmounted.
Fix accelerated independent transform animations vanishing when they start from a float residue.
14.3.0
15 Oct 2026stagger: Newgrid,from: "edges" | "random"options.Support for
scaleZ.Fix matrix3d and other digit-named transform functions being tokenised as numbers.
Added
stagger: Newgrid,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.
14.2.0
13 Oct 2026Hardware accelerated independent transforms like
x,y,scaleXetc.
14.1.1
13 Oct 2026Fix velocity hand-off for hardware-accelerated springs.
cubicBezier: More accurate, 2x faster.Reorder: Fix click events on reoredered items.
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.
14.1.0
9 Oct 2026animateLayout: Layout animations for vanilla JS.Delay animation start when main thread held to prevent visual jumps.
Fix
whileHover/whileTapgetting stuck after Fast Refresh reorders siblings.
Added
animateLayout: Layout animations for vanilla JS.
Fixed
Delay animation start when main thread held to prevent visual jumps.
Fix
whileHover/whileTapgetting stuck after Fast Refresh reorders siblings.scroll/useScroll: Fix reporting of elastic overscroll.AnimatePresence: FixpopLayoutwhen rendering into another window or iframe.animate: Fix JS animations jumping ahead when played after a pause at non-1speed.Allow layout animations inside dragged elements.
14.0.0
2 Oct 2026Removed internal APIs restored in
13.5.1for compatibility withframer-motion13.0–13.4. Future removed internal APIs won't cause cross-compatibility issues since pinning internalframer-motion,motion-domandmotion-utilsdependencies.
- 13.x
13.5.1
2 Oct 2026<motion>: Fall back to the attribute in readSVGValue when computed style is empty.<motion>: Internal changes toanimateChangesfor size reductions.scroll: Temporarily reverted removal of internalobserveTimelineAPI to fix compatibility with previous13.xAPIs. Moving to pinned dependencies before removing in14.x.
Changed
<motion>: Fall back to the attribute in readSVGValue when computed style is empty.<motion>: Internal changes toanimateChangesfor size reductions.
Fixed
scroll: Temporarily reverted removal of internalobserveTimelineAPI to fix compatibility with previous13.xAPIs. Moving to pinned dependencies before removing in14.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>: FixsortNodePositionthrowing when a sibling hasn't mounted
13.5.0
1 Oct 2026spring: Now accepts negativebounce(0--1) to define overdamped springs.<m>: 20% smaller.useSpring: 10% smaller.
Added
spring: Now accepts negativebounce(0--1) to define overdamped springs.
Changed
<m>: 20% smaller.useSpring: 10% smaller.scroll/useScroll: Use main thread for alloffsetanimations.
Fixed
Ensure
warninganderrormessages are cleaned from production build.Ensure values are never rendered before they've been resolved.
13.4.6
29 Sep 2026AnimatePresence:mode="wait"no longer drops new children ifexitcompletes during a React transition.
13.4.5
29 Sep 2026layout: 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.
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.
13.4.4
25 Sep 2026scroll: 44% smaller.useScroll: 33% smaller.Scroll callbacks: 50% faster.
Changed
scroll: 44% smaller.useScroll: 33% smaller.Scroll callbacks: 50% faster.
Removed
ScrollTimelinesupport for JS callbacks as benchmarked no improvement overscrollInfo.
Fixed
useDragControls: FixedsnapToCursororigin drift on repeated calls.drag: Improvedpointerendtiming.spring: Check invalid spring values before applying.AnimatePresence: Ensure children don't stick during reentry.
13.4.3
24 Sep 2026<motion>: Ensure animations replay whenSuspensereveals memoized content.
13.4.2
23 Sep 2026Reorder: Don't scale position of elements at origin0whendragConstraintschanges.Unrecognised easing names no longer throw.
13.4.1
22 Sep 2026animate: CSS variable writes on SVGs apply tostyleattribute.
13.4.0
16 Sep 2026AnimateView: View transitions for React 19.3, built on React'sViewTransition.
13.3.0
14 Sep 2026Hooks for Motion Editor.
springValue/useSpring: 80% reduction in time when retargeting.animate: 10% smaller.
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.
13.2.0
2 Sep 2026- removed
MotionValueStateno longer caches values inlatest; effect renders read their motion values directly.set()drops itsuseDefaultValueTypeargument. animate.addEffect()for registering effects that letsanimatedrive non-DOM subjects alongside DOM elements.threeEffect(motion/three) supporting Three.js objects, materials, shader uniforms, TSL uniform nodes and more.
Added
animate.addEffect()for registering effects that letsanimatedrive 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/Computebindings ("params.time"), scene nodes, cameras, lights, materials, orbit controls, CSS colors and vector components.createEffectnow acceptstest,readandstepoptions and exposes bound motion values viaeffect.get().
Changed
Reduced filesize and improved performance of
spring.- removed
MotionValueStateno longer caches values inlatest; effect renders read their motion values directly.set()drops itsuseDefaultValueTypeargument.
13.1.1
20 Aug 2026Guard animation
windowaccess in non-browser runtimes.AnimatePresence: Improved compat with React 19 strict mode.
13.1.0
10 Aug 2026Reorder: Multidimensional reorder.Reorder: Automatic axis detection.Reorder: RTL support.
13.0.0
5 Aug 2026Removed optional
@emotion/is-prop-validdependency in favour of explicit<MotionConfig isValidProp={isPropValid}>.Hardware-accelerated SVG elements correctly apply final style on animation complete.
AnimatePresence: Ensure nodes are marked as safe to remove when renderingpropagatewith nomotionchildren.
- 12.x
12.43.0
28 Jul 2026Reading the note…
12.42.2
30 Jun 2026Reading the note…
12.42.1
30 Jun 2026Reading the note…
12.42.0
25 Jun 2026Reading the note…
12.41.0
23 Jun 2026Reading the note…
12.40.0
21 May 2026Reading the note…
12.39.0
18 May 2026Reading the note…
12.38.0
17 Mar 2026Reading the note…
12.37.0
16 Mar 2026Reading the note…
12.36.0
12 Mar 2026Reading the note…
12.35.2
9 Mar 2026Reading the note…
12.35.1
7 Mar 2026Reading the note…
12.35.0
4 Mar 2026Reading the note…
12.34.5
3 Mar 2026Reading the note…
12.34.4
2 Mar 2026Reading the note…
12.34.3
20 Feb 2026Reading the note…
12.34.2
18 Feb 2026Reading the note…
12.34.1
17 Feb 2026Reading the note…
12.34.0
9 Feb 2026Reading the note…
12.33.2
9 Feb 2026Reading the note…
12.33.0
5 Feb 2026Reading the note…
12.32.0
5 Feb 2026Reading the note…
12.31.3
5 Feb 2026Reading the note…
12.31.2
5 Feb 2026Reading the note…
12.31.1
5 Feb 2026Reading the note…