shimmer_ai 1.2.0
shimmer_ai: ^1.2.0 copied to clipboard
Effortless shimmer effects and skeleton loaders for Flutter widgets using `.withShimmerAi()` — smooth, customizable, and dependency-free.
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 |