smart_image 1.0.7
smart_image: ^1.0.7 copied to clipboard
A powerful image widget that supports network/asset/file/svg images, fallback initials, blurhash, shimmer, and online status badges.
Smart Image #
A powerful and customizable image widget for Flutter that supports:
✅ Network, Asset, File & SVG images
✅ Name initials fallback (Avatar support)
✅ Dynamic initials text style
✅ Shimmer, BlurHash & Fade-in animations
✅ Tooltip + Semantics for accessibility
✅ Circle + Rounded shapes
✅ Border radius + Background color + Padding
✅ Error placeholder support
✅ Cached images for better performance
📸 Preview #
📦 Installation #
Add the package to your pubspec.yaml:
dependencies:
smart_image: ^1.0.7
🚀 Usage #
✅ Basic Usage – Network Image #
SmartImage(
imageUrl: "https://example.com/profile.jpg",
height: 80,
width: 80,
borderRadius: 12,
)
✅ Fallback: Initials Avatar – Circular #
SmartImage(
name: "Ashish Mistry",
width: 80,
height: 80,
useNameAsFallback: true,
backgroundColor: Colors.purple,
textColor: Colors.white,
)
✅ Rounded Initials + Dynamic TextStyle #
SmartImage(
name: "Smart Image",
width: 80,
height: 80,
initialsShape: AvatarShape.rounded,
borderRadius: 12,
initialsTextStyle: TextStyle(
fontWeight: FontWeight.bold,
color: Colors.white,
),
useNameAsFallback: true,
)
✅ BlurHash Placeholder + Cached Image #
SmartImage(
imageUrl: "https://example.com/photo.png",
blurHash: "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
loadingAnimation: LoadingAnimation.blurhash,
width: 80,
height: 80,
)
✨ Feature Support Table #
| Feature | Support |
|---|---|
| Network image | ✅ |
| Asset image | ✅ |
| File image | ✅ |
| SVG support | ✅ |
| Initials fallback | ✅ |
| Dynamic initials text style | ✅ |
| Shimmer placeholder | ✅ |
| BlurHash placeholder | ✅ |
| Fade-in animation | ✅ |
| Cached image | ✅ |
📝 License #
This package is available under the MIT License.