Changed #

• 🎯 Simplified API: Unified constructor pattern - use ImageBuilder(source) for all image types
• 📦 Unified source parameter: The constructor now accepts String, File, or Uint8List directly
• ✨ Cleaner API: More intuitive interface with automatic type detection

Deprecated #

• ⚠️ ImageBuilder.file(): Use ImageBuilder(file) instead. Will be removed in v2.0.0
• ⚠️ ImageBuilder.memory(): Use ImageBuilder(bytes) instead. Will be removed in v2.0.0
• 🔄 Migration guide:
  • Replace ImageBuilder.file(myFile) with ImageBuilder(myFile)
  • Replace ImageBuilder.memory(myBytes) with ImageBuilder(myBytes)
  • The default constructor ImageBuilder('path') remains unchanged
• ⏰ Timeline: Deprecated constructors still work but will show warnings. They will be removed in version 2.0.0

Updated #

• � Version bump: Updated to 1.1.4 for republication
• 🎨 Code formatting: Applied dart format to ensure all code meets pub.flutter-io.cn standards
• ✨ Package maintenance: Routine update to maintain package quality

Fixed #

• 🔗 Homepage and Repository URLs: Added valid homepage and repository entries to pubspec.yaml to fix pub.flutter-io.cn scoring
• 📦 Pub.dev compliance: Should now achieve full 160/160 pub points
• 🎯 Package metadata: Complete package information for better discoverability

Fixed #

[1.1.2] - 2025-09-28 #

Fixed #

• 🎨 Code formatting: Applied dart format to all files to meet pub.flutter-io.cn static analysis requirements
• 🔧 Package description: Shortened description to meet pub.flutter-io.cn requirements (60-180 characters)
• � URL validation: Removed unreachable repository URLs to improve pub.flutter-io.cn scoring
• �📦 Pub.dev compliance: Fixed all addressable issues identified in package analysis for better pub points
• ⚠️ Platform support: Note - Web platform limitations come from cached_network_image dependency, not package code

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.1.1] - 2025-09-28 #

Fixed #

• 🔧 Package description: Shortened description to meet pub.flutter-io.cn requirements (60-180 characters)
• 🔗 URL validation: Removed non-existent repository URLs to improve pub.flutter-io.cn scoring
• 📦 Pub.dev compliance: Fixed issues identified in package analysis for better pub points

Added #

• 📁 File image support: New ImageBuilder.file() constructor for loading images from device files
• 💾 Memory image support: New ImageBuilder.memory() constructor for displaying images from Uint8List data
• 🎯 Loading color customization: New loadingColor parameter for customizing adaptive loading indicator colors
• 🔄 Platform-adaptive loading indicators:
  • iOS/macOS: CupertinoActivityIndicator for native look
  • Android/Web/Others: CircularProgressIndicator for Material Design
• 🛡️ Enhanced error handling: Bulletproof network error handling prevents cascading crashes
• 🧪 Comprehensive test suite: 25+ test cases covering all functionality including file/memory images
• 📱 Multi-platform support: Full iOS, macOS, Android, Web compatibility
• 📖 Enhanced example app: Interactive file picker with cross-platform image upload functionality
• 🔐 macOS network permissions: Proper entitlements for network image loading
• 📝 Comprehensive comments: All test files include detailed explanatory comments

Changed #

• ♻️ Simplified API: Unified constructor patterns with cleaner parameter structure
• 🎨 Improved example app: Real device file picker integration showcasing ImageBuilder.file()
• 📚 Enhanced README: Complete rewrite with better organization, more examples, and updated API reference
• 🔧 Updated dependencies: flutter_svg updated to ^2.0.9 for better compatibility

Fixed #

• 🐛 Network error crashes: Fixed cascading StackTrace errors in web environment
• 🔧 Web compatibility: Improved error handling for web-specific issues
• 🎯 Loading indicator reliability: Consistent behavior across all platforms
• 📱 File handling edge cases: Better error recovery for invalid file paths and corrupted data

Added #

• 🎉 Initial release of ImageBuilder package
• 🌐 Network image support with caching via cached_network_image
• 📱 Local asset support for PNG, JPG, JPEG, WEBP formats
• 🎨 SVG support with color customization via flutter_svg
• 🔍 Automatic format detection based on file extension
• ⚡ Built-in error handling and fallback widgets
• 🔄 Loading placeholders for network images
• 📏 Flexible sizing options (width/height or unified size parameter)
• 📊 Comprehensive logging for debugging
• 🏗️ Multiple constructors: ImageBuilder.image() and ImageBuilder.network()

Features #

• 🖼️ Multiple image format support
• 🌐 Network image caching
• 🎨 SVG color customization
• ⚡ Error handling with fallback widgets
• 🔄 Loading states for network images
• 📏 Flexible sizing options