NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4107 most downloaded on npm
A simple and powerful JavaScript animation library
Latest stable
14.14.0
Last release 8 days ago
13 Nov 2026
Ships fairly regularly
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
1424 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Fixing types of Reorder.Item and Reorder.Group so incorrect HTML props are correctly flagged.
Reorder.Item and Reorder.Group so incorrect HTML props are correctly flagged.externalRef when it switches.Fixed issue where motion components don't update refs when externalRef changes. The useMotionRef function now properly includes externalRef in the dep
useMotionRef function now properly includes externalRef in the dependency array to ensure ref callbacks update when the external ref changes.Exporting internal APIs for use in view animations.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Children of variants with delayChildren: stagger() will now be staggered correctly alongside their newly-entering siblings.
delayChildren: stagger() will now be staggered correctly alongside their newly-entering siblings.Fixed shared layout animation in situations where no motion components have re-rendered between shared element switching.
motion components have re-rendered between shared element switching.Removing redundant renderRequest MotionValue lifecycle.
renderRequest MotionValue lifecycle.Removed additional removeNode from AnimatePresence when using popLayout.
springValue cleanup.removeNode from AnimatePresence when using popLayout.Added explainer for reduced motion warning.
motion component creation to remove indirection.Fix animation timings within dynamically-generated popups.
useScroll: Re-attempt to initialise scroll animation within a useEffect if refs weren't hydrated during the useLayoutEffect. Throw if refs are still n
useScroll: Re-attempt to initialise scroll animation within a useEffect if refs weren't hydrated during the useLayoutEffect. Throw if refs are still not hydrated during the useEffect.Added pages for remaining error and warning messages.
Improved error messages. Some error messages will now link through to detailed documentation and solutions.
Add .stop() and .cancel() methods to useDragControls().
.stop() and .cancel() methods to useDragControls().Allow delayChildren to accept stagger(). This enables from and ease options when staggering variant children.
delayChildren to accept stagger(). This enables from and ease options when staggering variant children.staggerChildren and staggerDirection options.Improve performance of projection styles by writing directly to element.style.
element.style.Improve performance of render loop.
Always skip layout animation check on tree mount.
Updated Transition type to be more permissive.
Transition type to be more permissive.Updated Target type to match previous definition.
Target type to match previous definition.Pass a shadow DOM root element via AnimatePresence root prop to attach "popLayout" styles to a different root element.
AnimatePresence root prop to attach "popLayout" styles to a different root element.Ensure animations are removed from scope when finished.
Add transformPerspective to TargetAndTransition.
transformPerspective to TargetAndTransition.CSSStyleDeclaration.Nothing published for this version
Nothing published for this version
Nothing published for this version
React: Prevent duplicate layout animation commits within Suspense boundaries.
React: Fix export * error message in Next.js.
export * error message in Next.js.React: usePageInView for tracking document visibility.
usePageInView for tracking document visibility.Fixed es bundle dependency imports for "motion".
"motion".translateX, originX etc values in animation targets.Removed "react" import from "motion-dom".
"react" import from "motion-dom".Support for defining a timeline position relative to the start of the most recently added animation (e.g. <+0.5, <-1)
<+0.5, <-1)Refactored MotionProps into vanilla MotionNodeOptions type within "motion-dom" package.
MotionProps into vanilla MotionNodeOptions type within "motion-dom" package.Handle colors when creating animatable "none" keyframes for complex strings.
"none" keyframes for complex strings.Fixes isValidProp check with Rolldown.
isValidProp check with Rolldown.Improved rounding for linear() easing curves.
linear() easing curves.Nothing published for this version
Nothing published for this version
Nothing published for this version
### Added - resize().
resize().Support for pathLength/pathSpacing/pathOffset for svgEffect.
pathLength/pathSpacing/pathOffset for svgEffect.data and aria attributes in attrEffect.attrEffect applies attributes via JS property where possible.transform-box: fill-box for SVGs with transform in styleEffect.Support for originX/Y/Z in styleEffect.
originX/Y/Z in styleEffect.svgEffect, propEffect and attrEffect.
svgEffect, propEffect and attrEffect.Ensure scroll updates are only triggered after a scroll read.
Nothing published for this version
Checks for instanceof HTMLElement made compatible with dynamically generated iframes.
instanceof HTMLElement made compatible with dynamically generated iframes.Fixed various typos in the type definitions along with a stale documentation link.
springValueOnly read transform from the DOM for initial independent transforms when there's no active projection.
transform from the DOM for initial independent transforms when there's no active projection.useWillChange now only adds transform to will-change to prevent issues with prematurely flattened preserve-3d.
useWillChange now only adds transform to will-change to prevent issues with prematurely flattened preserve-3d.Removed __VERSION__ placeholder from motion value.
__VERSION__ placeholder from motion value.Reorder component.Default scroll tracking to document.scrollingElement.
scroll tracking to document.scrollingElement.Added value.isEffectActive for internal use.
value.isEffectActive for internal use.Stop firing .then() after .stop() and .cancel().
.then() after .stop() and .cancel().Fixed attaching multiple press handlers on the same element.
press handlers on the same element.Fixed layout animations jumping when interrupted.
Attempting to fix layout animations jumping when interrupted.
### Fixed - Fixed .cancel() after .stop().
.cancel() after .stop().Main thread scroll animations are now lazy, resolving after "scroll" events instead of every animation frame.
scroll animations are now lazy, resolving after "scroll" events instead of every animation frame.### Added - styleEffect now supports: - Default value types - Independent transforms - CSS variables
styleEffect now supports:
Fix mixing PopChild with Astro view transitions.
PopChild with Astro view transitions.Fix setting transformBox via style.
transformBox via style.One column per quarter.