shimmer_ai 1.2.1
shimmer_ai: ^1.2.1 copied to clipboard
Effortlessly add shimmer loading effects to any Flutter widget with a simple one-line extension `.withShimmerAi()`. Now with extensive customization options for colors, direction, angle, and custom gr [...]
Changelog #
All notable changes to this project will be documented in this file.
1.2.0 July 31, 2025 #
Released: July 31, 2025
Added #
- โจ Enhanced Customization: Introduced
ShimmerAiConfigfor granular control over shimmer appearance. baseColor,highlightColor: Control shimmer colors.duration: Adjust animation speed.direction: Set shimmer animation direction (LTR, RTL, TTB, BTT).angle: Define the angle of the shimmer effect.borderRadius: Customize border radius of rectangular placeholders.repeat: Control continuous looping.loopCount: Specify the number of animation loops.customGradient: Provide a customLinearGradientfor unique effects.- ๐งช New Test Cases: Added comprehensive widget tests for all new customization parameters to ensure functionality and prevent regressions, now testing the internal shimmer implementation.
Changed #
- โป๏ธ Refactored API:
withShimmerAi()extension now acceptsShimmerAiConfigor individual parameters for flexibility. - โ๏ธ Improved Placeholder Logic: Enhanced
ShimmerAiWrapperandShimmerPlaceholdersto utilizeShimmerAiConfigfor dynamic rendering. - ๐ Smarter Sizing: Refined
size_utils.dartto provide more accurate estimations for placeholder dimensions based on original widgets (e.g., Text, Container, SizedBox). - ๐ Updated Example:
example/lib/main.dartnow showcases all new customization options with various scenarios.
Fixed #
- ๐ Ensured all parameters propagate correctly from
withShimmerAito the underlying custom shimmer widget. - ๐ Improved handling of different widget types within
ShimmerAiWrapperfor more consistent placeholder generation.
1.1.0 July 25, 2025 #
Released: July 25, 2025
Changed #
- ๐ง Refactored package structure to modularize extensions, widgets, placeholders, and utilities.
- โป๏ธ Improved performance and widget rebuilding logic.
- ๐งน Cleaned codebase for null safety, code style, and pub.dev scoring improvements.
1.0.0 July 22, 2025 #
Released: July 22, 2025
๐ Initial release of shimmer_ai:
| Feature | Description |
|---|---|
| โจ Smooth shimmer animation | Built-in shimmer gradient animation to mimic content loading |
| ๐งฑ Reusable skeleton layout widgets | Customizable rectangular, rounded, and circular shimmer placeholders |
| ๐จ Full color and duration control | Adjust base color, highlight color, animation duration, and direction |
| ๐ Looping animation support | Supports continuous looping shimmer effect for async UIs |
| ๐ฑ Responsive layout support | Works across all screen sizes with adaptive behavior |
| ๐ก Perfect for | Loading states, skeleton UIs, onboarding placeholders, list/grid loaders |
| ๐งช example/lib/main.dart | Full working demo with vertical list, card UI, and use-case showcase |