Changelog

Added

• Skills: /motion skill. Includes design guidelines, performance tips, and API gotchas. Can reference the Motion Studio MCP for docs search.

• Skills: /css-spring skill. Generates CSS spring easing functions via the Motion Studio MCP.

• Skills: /see-transition skill. Visualise easing curves and springs via the Motion Studio MCP.

• Skills: Added new motion-ai-kit installer with interactive skill picker.

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.

Added

• ViewTimeline support for scroll and useScroll.

Fixed

• Handle % translate values in layout animations.

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

• useCarousel and useTicker: Provides offset motion value, which contains the unwrapped offset of a Carousel or Ticker.

Fixed

• Ticker: Improve accessibility attributes.

• Cursor: Fix when using with browser-native drag gestures.

• Updating ref type inference for Typewriter, Ticker and ScrambleText.

Added

• Carousel: New wheelSwipeThreshold prop configures the distance of wheel scroll before triggering a swipe.

Added

• AnimateNumber: trend prop to control digit spin direction.

  • trend={1}: Digits always spin upward, wrapping 9 → 0.

  • trend={-1}: Digits always spin downward, wrapping 0 → 9.

  • trend={(oldValue, newValue) => number}: Function for custom logic.

  • Default (no trend): Auto-detects direction based on value change.

Changed

• AnimateNumber: Now uses manual FLIP measurements instead of layout animations.

Fixed

• splitText: Ensure split text elements retain vertical positioning.

• Carousel: Fix focus from breaking item reprojection.

Added

• Extension: Added support for spring editing.

• Extension: Visual refresh.

• Skills: Added Motion Performance Audit skill.

Added

• AnimateView: View animations for React.

Fixed

• 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

• 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

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

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

• scrambleText: Fixed delay handling.

Added

• scrambleText: Now supports string MotionValue.

Changed

• ScrambleText: Removing span.