flutter_animate_plus 5.1.0

A maintained fork of flutter_animate with beautiful animated effects and builders for Flutter.

Changelog

All notable changes to this project will be documented in this file.

5.1.0 - 2026-09-10

Fixed

• Deliver time-zero callbacks on zero-total-duration timelines, including the optional first-frame rendering mode, while preserving deferred playback and callback ordering.
• Cancel delayed playback when an animation is removed; detach callbacks from caller-owned controllers.
• Safely switch between internal and external controllers.
• Apply updated subtree defaults before simultaneous target playback; preserve progress for scope-only updates.
• Dispose the initially hidden entry/exit recipe safely before it is shown.
• Release callback, listen and toggle effect subscriptions; avoid retaining CurvedAnimation status listeners.
• Keep toggle builders responsive to inherited changes such as theme and viewport size while filtering unchanged animation values.
• Keep zero-duration effects finite and deliver onPlay before synchronous onComplete.
• Honor documented delay behavior for initial target/value and respond to autoPlay updates.
• Handle zero scroll ranges, explicit zero origins and overscroll without NaN progress; preserve progress while unbounded ranges cannot resolve.
• Remove misleading warnings for valid state-driven autoPlay: false configurations.
• Dispose adapter tickers and use scheduler elapsed time for animated adapters.
• Use Flutter's native finite repeat support so loop futures complete without wall-clock timers.

Added

• AnimatePresence with cancellable entry/exit delays, exit retention, customizable transitions, input/semantics/focus exclusion and reduced-motion handling.
• SpringAdapter for bounded Flutter spring playback, target updates preserving position and velocity, and lifecycle-safe cancellation.
• About in the example with portfolio, Ko-fi, package/source links and upstream attribution; Cloudflare Pages configuration and deployment guide.
• ImplicitAnimate / animateImplicitly() for independent endpoint updates in exactly Fade, Scale, Slide and Move effects, including interruption, cancellable delays and reduced motion.
• AnimateInitCallback: an onInit bool result overrides initial autoplay; existing void callbacks remain accepted, and non-bool or async results do not change autoplay.
• Opt-in preRenderZeroDuration for eligible automatic zero-total-duration timelines, retaining asynchronous playback and callbacks.
• RepeatAdapter with cancellable initial delay, idle pauses, finite counts and optional alternating directions; existing Effect.delay remains part of the active timeline.
• SliverFadeEffect / sliverFade and SliverMoveEffect / sliverMove for whole sliver sections, plus an executable list/grid recipe with replay and reduced-motion support.
• Optional inherited reverseCurve with lifecycle-safe subscriptions and Flutter-compatible direction changes.
• Absolute and fractional layout-size effects (size, width, height and percentage variants).
• AnimateDefaults for subtree duration, effect delay and curves.
• ValueNotifierAdapter.transformer, AnimationAdapter and ScrollAdapter.getPosition.
• 24 named directional fade/slide/flip/zoom/bounce presets and 25 declarative equivalents of existing shorthand variants.
• Executable recipes for retained entry/exit with separate delays, native switcher integration, spring playback, implicit endpoint transitions and idle gaps between shimmer sweeps.
• Searchable effect catalog, copyable examples, real pause/resume, reduced-motion previews and a once-visible lazy-list integration in the example.
• Optional filterQuality on every scale variant for rendering control.
• @widgetFactory annotation for better Flutter Inspector attribution.
• Regression tests, complete open upstream issue audit and minimum/current SDK CI.
• Refreshed responsive example, replay controls, actual screenshots and reproducible animated GIF capture.

Compatibility

• Bool values previously returned by onInit and ignored now decide initial autoplay. Initialization-only callbacks with incidental bool returns should use a block without returning that value; ordinary void callbacks remain accepted.
• Retains Flutter >=3.41.4 and Dart ^3.11.1, existing effect defaults and both import paths.
• autoPlay changes now start/stop automatic playback; loop(count: ...) completes its future when finished.
• The original Animate timeline does not acquire implicit endpoint semantics. The new implicit API rejects unsupported effects and reverseCurve explicitly.
• Platform-specific visual reports remain documented in doc/issue-audit.md.

5.0.0 - 2026-03-15

Changed

• renamed the package to flutter_animate_plus
• raised the minimum supported SDK to Dart ^3.11.1 and Flutter >=3.41.4
• refreshed package metadata, CI, and the example app scaffolding for current Flutter tooling
• updated to flutter_lints ^6.0.0 and flutter_shaders ^0.1.3
• cleaned up deprecated APIs for current Flutter stable

4.5.2 - 2024-11-25

Changed

• remove unnecessary visibility_detector dependency

4.5.1 - 2024-11-21

Changed

• fix console formatting reset for warn prints

4.5.0 - 2024-01-31

Changed

• include ShaderEffect in export by default
• use AnimatedSampler from flutter_shaders package (versus copying it in)

4.4.1 - 2024-01-26

Changed

• improved documentation for extension methods

4.4.0 - 2024-01-08

Added

• Animate.value — sets the starting value/position of an animation

4.3.0 - 2023-09-21

Added

• AlignEffect - animate alignment
• transformHitTests on ScaleEffect and RotateEffect
• EffectList - build lists of effects with the chained API

Changed

• fix to properly support FollowPathEffect.rotate
• made extension method types less ambiguous
• fixed total animation duration when using ThenEffect
• updated to use super initializers
• other minor fixes / doc updates

4.2.0 - 2023-06-19

Added

• FollowPathEffect
• ShaderEffect - currently in prerelease & must be imported directly

Changed

• removed unused adapter param from AnimateList
• added more tests

4.1.1 - 2023-03-23

Changed

• fixed an issue with onPlay triggering on every rebuild

4.1.0 - 2023-02-13

Added

• Animate.autoPlay and AnimateList.autoPlay
• Animate.onInit and AnimateList.onInit
• AnimateList.delay
• debug warnings for some incompatible parameter combinations

Changed

• fixed issues with orphaned adapters causing errors

4.0.0 - 2023-02-13

Added

• CrossfadeEffect - cross fades in a new widget
• Adapter.direction - optionally update in only one direction

Changed

• major refactor of Adapter
• fix issue with adapters generating errors on disposed Animate instances
• improve smoothing for Adapter.animated
• improve adapter examples
• changed ThenEffect functionality to establish a new baseline time
• cleaned up tests & added tests for new effects

3.1.0 - 2023-01-30

Added

• added a few fun examples to the everything_view

Changed

• changed ShakeEffect.hz to a double
• added padding to ShimmerEffect to reduce visual issues with ShaderMask and antialiasing
• fix an error in the AnimationController.loop extension when the target was disposed

3.0.0 - 2023-01-19

Changed

• reorganize lib folder to follow dart guidance
• cleanup of documentation to improve consistency
• renamed test_view to playground_view

2.2.0 - 2023-01-15

Added

• ColorEffect - animate between two colors with a blend mode

Changed

• reset animation if onPlay changes
• simplified BoxShadowEffect implementation

2.1.0 - 2022-12-24

Added

• Animate.target for declarative animation
• BoxShadowEffect - animate BoxShadow
• ElevationEffect - animate elevation shadows
• Animate.restartOnHotReload static property

Changed

• fixed issues with low value blurs on web
• fixed errors with 0 sized gradients in ShimmerEffect
• removed optimizations that modify the display list

2.0.1 - 2022-10-30

Changed

• fixed ShakeEffect.hz calculations and adjusted defaults

2.0.0 - 2022-10-23

Added

• effects now use "smart" parameters. See README: Other Effect Parameters
• effects now expose default param values as static fields
• FlipEffect (2.5d card flip)
• loop extension to AnimationController
• support for non-uniform blurs in BlurEffect
• animated property for all adapters
• transformHitTest param on MoveEffect
• first set of automated tests

Changed

• changes to some effect extension methods (ex. move) to be more consistent
• fix for BlurEffect on the web with low sigma values
• exposed some effects' utility methods as static methods
• changed SwapEffect.builder method signature to have a non-nullable child
• minor documentation improvements and small fixes

Removed

• unblur extension method. Use blurXY with a begin value instead

1.0.0 - 2022-08-18

Added

• RotateEffect

Changed

• SwapEffect.builder now receives a reference to the original child
• Animate.onInit renamed to onPlay
• improved hot reload support

0.3.0 - 2022-06-20

Added

• .unblur() extension method
• .effect() extension method
• kitchen sink example view

Changed

• Optimized all effect builders to only build on value change
• Minor cleanup
• ShakeEffect now uses hz instead of count
• TintEffect now uses opaque black for default color
• Made CallbackEffect more robust

0.2.0 - 2022-06-17

Added

• Adapters: Drive animations from external sources (scrolling, notifiers, etc)
• ShakeEffect: translation and/or rotation based shaking effect
• SaturateEffect: Color saturation effect (ex. animate to grayscale)
• TintEffect: Animated color tint

Changed

• Fix issue with Animate delay returning after dispose
• Improved example

0.1.1 - 2022-05-31

Changed

• Fix a major widget lifecycle issue with Animate delay

0.1.0 - 2022-05-29

Added

• ShimmerEffect: can do a variety of gradient effects, including load shimmers
• ThenEffect: simplifies sequencing effects by calculating a new inheritable delay

Changed

• onInit & onComplete are now propagated to all children of AnimateList
• improved documentation
• Animate delay is now separate from the animation and only runs once
• Effect is now an empty effect instead of an abstract class
• Updated example
• Fixed an issue with property inheritance through multiple effects

0.0.1 - 2022-05-20

Added

• Initial pre-release