flutter_image_cache #

A Flutter package for efficient image caching with automatic cache management.
It downloads images from the web, stores them in a local cache, and automatically cleans old or unused images to stay within the specified cache size.

Features #

• Automatic caching of images downloaded from URLs.
• Cache size management with automatic cleanup.
• Cache usage tracking.
• Customizable placeholder, error handling, and frame builders.
• Thread-safe downloads and cache access using mutexes.

Limitations #

• The package currently supports only one cache instance at a time.
  Concurrent use of multiple CacheManager objects is not supported and may lead to unexpected behavior.
  It is therefore recommended to use a single, global instance of CacheManager throughout the entire application.

Getting Started #

Installation #

Add the flutter_image_cache package to your pubspec dependencies.

Usage #

Create a static CacheManager and pass it to the CachedImage widget constructor.
The API is similar to Image.file().

import "package:flutter_image_cache/flutter_image_cache.dart";

final CacheSize cacheSize = CacheSize(miB: 10); // Create a cache of maximum size 10 MiB
final static CacheManager cacheManager = CacheManager(maxCacheSize: cacheSize);

// Create the widget
CachedImage(
  "https://example.com/image.jpg",
  cacheManager: cacheManager,
)