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,
)

Support & Feedback

If you enjoy this project, consider leaving a ⭐ on GitHub and a 👍 on pub.dev for supporting it.

If something isn't working as expected, please open an issue on GitHub.

The same applies to feature requests: feel free to suggest improvements by creating a new issue.