ImageFlow 📷 #

An advanced image loader for Flutter with caching, placeholders, and progressive loading. ImageFlow provides optimized lazy loading capabilities, ensuring your app's images load efficiently and smoothly.

✨ Features #

🏎️ Optimized Lazy Loading

• Loads images only when they become visible in the viewport
• Reduces memory usage and initial load time

🛠️ Advanced Caching Support

• Efficient local storage caching
• Customizable cache duration
• Automatic cache management

🔄 Placeholder & Error Handling

• Customizable loading placeholders
• Elegant error states
• Smooth transitions between states

📱 Adaptive Image Quality

• Progressive image loading
• Low-res to high-res transitions
• Bandwidth-aware loading

🚀 Prefetching & Preloading

• Smart preloading of off-screen images
• Configurable prefetch policies
• Background loading support

🌍 Network & Offline Support

• Offline-first approach
• Automatic network state detection
• Fallback mechanisms for offline usage

🎨 Extended Format Support

• GIF support
• SVG rendering
• Extensible format handlers

🚀 Getting Started #

Add this to your package's pubspec.yaml file:

dependencies:
  imageflow: ^1.0.1

💻 Usage #

import 'package:imageflow/imageflow.dart';

// Basic usage
ImageFlow(
  url: 'https://example.com/image.jpg',
)

// Advanced usage with all features
ImageFlow(
  url: 'https://example.com/image.jpg',
  placeholder: 'assets/placeholder.png',
  errorWidget: (context, error) => Icon(Icons.error),
  progressIndicatorBuilder: (context, progress) => CircularProgressIndicator(),
  cacheManager: CustomCacheManager(),
  preload: true,
)

🤝 Contributing #

Contributions are welcome! Please read our contributing guidelines first.

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.