safe_network_image 1.0.1
safe_network_image: ^1.0.1 copied to clipboard
A robust Flutter widget that extends cached_network_image with enhanced error handling, connectivity awareness, shimmer effects, and automatic retry functionality.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2025-06-03 #
1.0.1 - 2025-06-03 #
- Minor fixes and updates before first stable release
Added #
- Initial release of SafeNetworkImage widget
- Shimmer loading animation with customizable colors
- Automatic retry mechanism with configurable attempts and delays
- Network connectivity awareness and offline handling
- Multiple fallback options (icons and custom widgets)
- Pre-built variants: avatar, card, and banner image types
- Full accessibility support with semantic labels
- Touch gesture handling with onTap callbacks
- Performance optimizations with cached_network_image integration
- Comprehensive documentation and examples
- Support for custom border radius and image fitting
- Memory-efficient placeholder rendering
- Hardware-accelerated animations
Features #
SafeNetworkImage
- Main widget with full configuration optionsSafeNetworkImageBuilder.avatar()
- Circular profile imagesSafeNetworkImageBuilder.card()
- Product/content cardsSafeNetworkImageBuilder.banner()
- Full-width hero images- Connectivity monitoring with automatic retry on reconnection
- Customizable retry logic with exponential backoff support
- Accessibility features for screen readers
- Error state indicators with user-friendly messages
Dependencies #
cached_network_image: ^3.4.1
- Core image caching functionalityconnectivity_plus: ^6.1.4
- Network connectivity monitoringflutter: ">=3.0.0"
- Minimum Flutter version support
Compatibility #
- Dart SDK:
>=3.0.0 <4.0.0
- Flutter:
>=3.0.0
- Platforms: iOS, Android, Web, Desktop (Windows, macOS, Linux)