PackageTrack
Sign in Get early access

auto_shimmer_animate

A Flutter package that automatically converts existing widget trees into animated shimmer skeleton loading states.

0.2.1 kartikhadiya09/auto_shimmer_animate

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 2026
Release Pre-release

Releases

latest 6
  1. 0.2.1 04 Jun 2026
    Release notes
    • Improved default shimmer visibility with softer base colors, a white moving highlight, and tuned sweep timing.
    • Added selective child painting controls with onlyChildShimmer and blockChildShimmer.
    • 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.
    Open source →
  2. 0.2.0 02 Jun 2026
    Release notes
    • Added the built-in AutoShimmerLayer animation renderer.
    • Added AutoShimmerEffect with sweep, raw gradient, pulse, and aurora effects.
    • Added effect support to AutoShimmerAnimate, AutoShimmerStateAnimate, and AutoShimmerConfig.
    • Aligned default shimmer colors, gradient stops, bounds, and duration with the intended package style.
    • Removed the shimmer_animation dependency from pubspec.yaml.
    • Removed Shimmer and ShimmerDirection re-exports from the public API.
    • Removed unnecessary uses-material-design from pubspec.yaml.
    • Added SwitchListTile skeleton transformation support.
    • Improved card surface painting for custom ShapeBorder values.
    • Added a regression test for skeletonizing a Container inside Expanded.
    • 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.
    Open source →
  3. 0.1.1 01 Jun 2026
    Release notes

    Introduced the loadingBuilder parameter 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 loadingBuilder to AutoShimmerAnimate to 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 to 0.08.
    • Modified ShimmerWrapper to ensure highlightColor and highlightOpacity are applied even when animation overrides are not present.
    • Enhanced AutoShimmerAnimate logic to prioritize loadingBuilder over auto-generated skeletons.
    • Expanded README.md with detailed usage examples for layered skeletons, custom loading UI, and parameter tables.
    • Added comprehensive unit tests for loadingBuilder logic, shimmer builder wrapping, and color override persistence.
    • Updated CHANGELOG.md to reflect version 0.1.1 changes.
    Open source →
    Release notes
    • Fixed default shimmer highlight to use soft light grey instead of harsh pure white.
    • Reduced default highlight width for more subtle shimmer animation.
    • Added loadingBuilder parameter for custom loading UI (skips auto-skeleton generation).
    • Clarified shimmerBuilder usage: 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.
    Open source →
  4. 0.1.0 30 May 2026
    Release notes

    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 AutoShimmerScope to provide a shared animation controller and coordinate shader bounds across a widget subtree.
    • Added perElementShimmer, highlightOpacity, and highlightWidth to AutoShimmerConfig to allow fine-grained control over the shimmer highlight.
    • Updated SkeletonBox to optionally host its own AutoShimmerEffect, enabling per-widget animation masks.
    • Refactored CardAdapter and ContainerTransformer to use a stacked rendering approach, ensuring parent surfaces and child content maintain distinct skeleton layers.
    • Refined default visual constants, including updated colors in AutoShimmerColors and a shorter 1600ms default animation duration.
    • Introduced AutoShimmerGradient to centralize shimmer logic, including support for sliding transforms and adjustable highlight widths.
    • Updated AutoShimmerEffect to use BlendMode.srcATop and support external animation objects from AutoShimmerScope.
    • Expanded documentation in README.md with default value tables and tuning examples.
    • Added comprehensive tests for synchronized animations, localized shader bounds, and configuration defaults.
    Open source →
    Release notes
    • 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.
    Open source →
  5. 0.0.2 29 May 2026
    Release notes

    Replaced the shimmer_animation third-party dependency with a custom, internal animation engine to improve package independence and maintainability.

    • Introduced AutoShimmerEffect, a built-in animation engine utilizing ShaderMask and LinearGradient.
    • Added AutoShimmerDirection enum to replace external shimmer direction types.
    • Added repeatDelay support to AutoShimmerAnimate, AutoShimmerConfig, and related builders to control timing between animation loops.
    • Deprecated the interval property in favor of repeatDelay for better naming consistency.
    • Updated ShimmerWrapper to use the new internal AutoShimmerEffect instead of the external Shimmer widget.
    • Updated unit tests to verify AutoShimmerEffect behavior, including repeatDelay and disabled states.
    • Updated documentation and examples to reflect the new API changes and internal engine.
    • Bumped package version to 0.0.2.
    Open source →
    Release notes
    • Removed third-party shimmer animation dependency.
    • Added built-in shimmer animation engine.
    • Added repeatDelay support.
    • Added internal shimmer direction enum.
    • Improved package independence and maintainability.
    Open source →
  6. 0.0.1 28 May 2026
    Release notes

    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.yaml to match the repository name.
    Open source →
    Release notes

    Added

    • Initial release of auto_shimmer_animate.
    • AutoShimmerAnimate for boolean loading states.
    • AutoShimmerStateAnimate<T> for enum, string, object, and custom state values.
    • AutoShimmerTheme and AutoShimmerConfig for subtree defaults.
    • Automatic skeleton conversion for common Flutter widgets.
    • Custom shimmer builder support.
    • Runnable example application and pub.dev demo GIF.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive