NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #190 most downloaded on pub.dev
Generic cache manager for flutter. Saves web files on the storages of the device and saves the cache info using sqflite.
Latest stable
3.5.0
Last release 18 days ago
04 Nov 2026
Ships unpredictably
gaps range from 8 days to 1.9 years
Nearly every release is documented
notes for 50 of 51 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
66 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
…maxHeight being ignored when maxWidth is set. Deprecates supportedFileNames.
Lets the image engine decide whether a cached file can be resized, passes animated images through, returns the original file with a warning when decoding or resizing fails, and fixes maxHeight being ignored when maxWidth is set. Deprecates supportedFileNames.
supportedFileNames: whether an image is resized is now decided by the image engine from the file's content instead of from the file extension derived from the Content-Type header of the response (#475)Content-Type such as application/octet-stream; files that are not images are returned untouched.png extension, matching the encoding that is used, instead of reusing the extension derived from the Content-Type headercacheLogger when an image cannot be decoded or resized, instead of erroring the stream. This reverses the decode error propagation introduced in 3.4.5 for #400Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix: preserve URL extensions for generic downloads
fix: preserve URL extensions for generic downloads
test: cover download extension fallback
Keep URL extension fallback safe and compatible
fix: validate URL extension fallback
Clarify URL extension changelog entry
Bump package version after rebase
Fix URL fallback for custom HTTP clients
application/octet-stream or binary/octet-stream (#489).Co-authored-by: Claude noreply@anthropic.com
Co-authored-by: Claude noreply@anthropic.com
Co-authored-by: Claude noreply@anthropic.com
Co-authored-by: Claude noreply@anthropic.com
CacheStore (#535).fix: prevent image decode future from completing twice
fix: prevent image decode future from completing twice
chore: bump package version to 3.4.5
Await store.putFile so cache info is actually persisted
putFile, putFileStream, and downloads started persist without waiting.
After those calls returned, CacheObject.id could still be null, so
removeFile skipped the entry and a process exit could lose the info.
Fixes #492
Catch FileSystemException when deleting a stale cache file.
Drop the extra Config import, wrap the long test lines, and document
that a failed cache-info write now surfaces to the caller.
Move the persist-await changelog entry out of 3.4.3 and set the package version.
putFile, putFileStream, and downloads so the stored object has an id before those calls return (#492). A failed repository write now throws from putFile/putFileStream and errors the download stream instead of returning a usable file with no cache-info row.added flutter setup in workflow
added flutter setup in workflow
JsonCacheInfoRepository losing metadata when the app exits within 3 seconds of a cache change by writing through promptly with serialized, atomic file writes (#491)HttpExceptionWithStatus to satisfy the stricter use_super_parameters lint in Dart 3.13 (no API or behavior change)path_provider_android to 2.2.22 to avoid transitive jni / jni_flutter AGP 9 issuesCLAUDE.md that imports AGENTS.md and holds Claude Code-specific contributor notesAGENTS.md (previously git-ignored) and trims it to technical content: architecture, directory map, fork workflow, commands, testing, and PR checklisthomepage at the repository root instead of a branch-specific URLFixes removeFile deleting from the wrong path
removeFile deleting from the wrong pathTarget js_interop for Wasm support
move to flutter_lint by @renefloor in https://github.com/Baseflow/flutter_cache_manager/pull/351
compileSdkVersion by @sidrao2006 in https://github.com/Baseflow/flutter_cache_manager/pull/374platform declaration to pubspec.yaml by @sidrao2006 in https://github.com/Baseflow/flutter_cache_manager/pull/375Full Changelog: https://github.com/Baseflow/flutter_cache_manager/compare/v3.3.0...v3.4.0
* Updates dependencies
Update Dart SDK constraint
Update Dart SDK constraint
Support Dart 3.0.0 for http ^1.0.0 and file ^7.0.0
Added option to manage the log level. Doesn't print failed downloads by default anymore. You can set it like this:
CacheManager.logLevel = CacheManagerLogLevel.verbose;
[Bugfix] getSingleFile now downloads a new file before completing as the outdated file might have been deleted.
Disabled resizing of cached gifs as this was broken.
removeFile function now completes after the file is removed from disk and not earlier
Move File to separate file. You can add it using the following import:
import 'package:flutter_cache_manager/file.dart' as cache_file;
Bugfix for loading multiple images simultaneously
Include rxdart 0.27 as possible dependency
Include file 6.0.0 as possible dependency
Bug fix on removing a relatively new file from cache
Add null-check on id in removeFile
* Fix sqflite warning
Bug fix for NonStoringObjectProvider.
* Migration to nullsafety.
Bug fix for JsonCacheInfoRepository when file is corrupted.
Update minimal dependency sqflite
Added ImageCacheManager with support for image resizing.
BREAKING CHANGE Creating a CacheManager now requires a Config object, see the readme for complete example.
maxAgeCacheObject to stalePeriodReintroduced BaseCacheManager interface for backwards compatibility.
BREAKING CHANGE Creating a CacheManager now requires a Config object, see the readme for complete example.
maxAgeCacheObject to stalePeriodCompatibility with Flutter version 1.22.
Bugfix: CacheManager returned a file that didn't exist when the file was removed by the OS (or any other external system) while the app was active. Th
Allow cleaning of memory cache (PR #183).
Basic web support. (At least it downloads the file for you.)
* Support for RxDart 0.24.x
Fixed optional parameters in the Content-Type header (#164).
Added getFileStream to CacheManager
Use try-catch in WebHelper so VM understands that errors are not uncaught.
Better error handling (really better this time).
Changed error handling back to throwing the error as it is supposed to be.
New method to get fileinfo from memory.
Keep SQL connection open during session.
Fixed image loading after loading failed once.
* Added method to clear cache
Use of SQFlite instead of shared preferences for cache info
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed library compatibility issue
Nothing published for this version
Fixed library compatibility issue
Fixed some issues when file could not be downloaded the first time it is trying to be retrieved.
Fixed ConcurrentModificationError in cache cleaning
One column per quarter.