auto_shimmer_animate
A Flutter package that automatically converts existing widget trees into animated shimmer skeleton loading states.
What this package is like to depend on
Last release 2 months ago
04 Jun 2026
Too new to tell
only 1 release windows
Nearly every release is documented
notes for 6 of 6 stable releases
Nothing withdrawn
no release was ever pulled
2 months old
6 releases · first in 2026
6 releases in the last 12 months
see the full history below
Release timeline
6 releases · May 2026 to Jun 2026Releases
latest 6-
0.2.104 Jun 2026Release notes
Open source →- Improved default shimmer visibility with softer base colors, a white moving highlight, and tuned sweep timing.
- Added selective child painting controls with
onlyChildShimmerandblockChildShimmer. - Improved shimmer rendering so parent surfaces and child skeleton details stay visible together.
- Improved card/container skeleton handling for nested child layouts.
- Expanded tests for default shimmer values, nested container rendering, child skeleton modes, aurora configuration, and switch list tiles.
- Reworked the example app around one shared product item with tabs for all package features.
- Replaced the old README/pub.dev GIF set with the new tab-based example GIFs.
- Updated the README use cases with side-by-side previews and compact code-only examples.
-
0.2.002 Jun 2026Release notes
Open source →- Added the built-in
AutoShimmerLayeranimation renderer. - Added
AutoShimmerEffectwith sweep, raw gradient, pulse, and aurora effects. - Added
effectsupport toAutoShimmerAnimate,AutoShimmerStateAnimate, andAutoShimmerConfig. - Aligned default shimmer colors, gradient stops, bounds, and duration with the intended package style.
- Removed the
shimmer_animationdependency frompubspec.yaml. - Removed
ShimmerandShimmerDirectionre-exports from the public API. - Removed unnecessary
uses-material-designfrompubspec.yaml. - Added
SwitchListTileskeleton transformation support. - Improved card surface painting for custom
ShapeBordervalues. - Added a regression test for skeletonizing a
ContainerinsideExpanded. - Updated the example with an aurora tab ready for screen recording.
- Replaced the old demo screenshot with separate default, custom color, state, custom builder, and aurora GIFs.
- Reworked the README with side-by-side use cases, effect, theme, state, builder, and example guidance.
- Added the built-in
-
0.1.101 Jun 2026Release notes
Open source →Introduced the
loadingBuilderparameter to allow for manual loading UI while bypassing automatic skeleton generation. Refined default visual constants for a more subtle shimmer effect and improved color configuration handling.- Added
loadingBuildertoAutoShimmerAnimateto support custom loading widgets that still benefit from the shimmer animation. - Updated default highlight color to a soft light grey (
0xFFFAFAFA) and reduced default highlight width to0.08. - Modified
ShimmerWrapperto ensurehighlightColorandhighlightOpacityare applied even when animation overrides are not present. - Enhanced
AutoShimmerAnimatelogic to prioritizeloadingBuilderover auto-generated skeletons. - Expanded
README.mdwith detailed usage examples for layered skeletons, custom loading UI, and parameter tables. - Added comprehensive unit tests for
loadingBuilderlogic, shimmer builder wrapping, and color override persistence. - Updated
CHANGELOG.mdto reflect version 0.1.1 changes.
Release notes
Open source →- Fixed default shimmer highlight to use soft light grey instead of harsh pure white.
- Reduced default highlight width for more subtle shimmer animation.
- Added
loadingBuilderparameter for custom loading UI (skips auto-skeleton generation). - Clarified
shimmerBuilderusage: wraps generated skeleton with custom animation only. - Improved color behavior: user-provided colors are always respected exactly.
- Updated README with custom loading UI and shimmer animation builder examples.
- Added
-
0.1.030 May 2026Release notes
Open source →Introduced a synchronized animation system that allows individual skeleton elements to animate in unison while maintaining their own clipping bounds. This improves the visual quality of layered skeletons, specifically for nested widgets like Cards and Containers.
- Introduced
AutoShimmerScopeto provide a shared animation controller and coordinate shader bounds across a widget subtree. - Added
perElementShimmer,highlightOpacity, andhighlightWidthtoAutoShimmerConfigto allow fine-grained control over the shimmer highlight. - Updated
SkeletonBoxto optionally host its ownAutoShimmerEffect, enabling per-widget animation masks. - Refactored
CardAdapterandContainerTransformerto use a stacked rendering approach, ensuring parent surfaces and child content maintain distinct skeleton layers. - Refined default visual constants, including updated colors in
AutoShimmerColorsand a shorter 1600ms default animation duration. - Introduced
AutoShimmerGradientto centralize shimmer logic, including support for sliding transforms and adjustable highlight widths. - Updated
AutoShimmerEffectto useBlendMode.srcATopand support external animation objects fromAutoShimmerScope. - Expanded documentation in
README.mdwith default value tables and tuning examples. - Added comprehensive tests for synchronized animations, localized shader bounds, and configuration defaults.
Release notes
Open source →- Added layered skeleton rendering.
- Added childBaseColor customization.
- Added layeredSkeleton toggle.
- Improved default shimmer appearance.
- Improved container, card, image, icon and text skeleton rendering.
- Improved default shimmer color contrast.
- Added synchronized per-element shimmer animation.
- Added highlightOpacity and highlightWidth tuning.
- Improved shared shimmer gradient alignment.
- Kept optional color overrides default-safe.
- Introduced
-
0.0.229 May 2026Release notes
Open source →Replaced the
shimmer_animationthird-party dependency with a custom, internal animation engine to improve package independence and maintainability.- Introduced
AutoShimmerEffect, a built-in animation engine utilizingShaderMaskandLinearGradient. - Added
AutoShimmerDirectionenum to replace external shimmer direction types. - Added
repeatDelaysupport toAutoShimmerAnimate,AutoShimmerConfig, and related builders to control timing between animation loops. - Deprecated the
intervalproperty in favor ofrepeatDelayfor better naming consistency. - Updated
ShimmerWrapperto use the new internalAutoShimmerEffectinstead of the externalShimmerwidget. - Updated unit tests to verify
AutoShimmerEffectbehavior, includingrepeatDelayand disabled states. - Updated documentation and examples to reflect the new API changes and internal engine.
- Bumped package version to 0.0.2.
Release notes
Open source →- Removed third-party shimmer animation dependency.
- Added built-in shimmer animation engine.
- Added
repeatDelaysupport. - Added internal shimmer direction enum.
- Improved package independence and maintainability.
- Introduced
-
0.0.128 May 2026Release notes
Open source →Updated the README with badges, streamlined documentation, and simplified code examples. Corrected the repository, homepage, and issue tracker links in
pubspec.yaml.- Refactor README for conciseness and add pub.dev badges.
- Convert API overview to a table format.
- Simplify usage examples and remove redundant sections.
- Update project URLs in
pubspec.yamlto match the repository name.
Release notes
Open source →Added
- Initial release of
auto_shimmer_animate. AutoShimmerAnimatefor boolean loading states.AutoShimmerStateAnimate<T>for enum, string, object, and custom state values.AutoShimmerThemeandAutoShimmerConfigfor subtree defaults.- Automatic skeleton conversion for common Flutter widgets.
- Custom shimmer builder support.
- Runnable example application and pub.dev demo GIF.