Cache Network Media #

Because reinventing the wheel is overrated. Efficiently cache network images, SVG graphics, and Lottie animations in Flutter.

Features #

Stop downloading the same image 47 times per session. This package provides:

• Image Caching - PNG, JPG, WebP, GIF. Yes, even those animated cat GIFs.
• SVG Support - Vector graphics that actually scale without pixelation nightmares.
• Lottie Animations - Because sometimes static images just don't cut it.
• Disk Caching - Persistent storage that survives app restarts (unlike your user's patience).
• Offline Support - Display cached media when the internet decides to take a vacation.
• Optimized Performance - File-based caching for Lottie because we actually care about performance.
• Clean API - Named constructors that make sense. Revolutionary concept, we know.

Installation #

Add this to your pubspec.yaml (you know the drill):

dependencies:
  cache_network_media: ^0.0.1

Then run the command you've run 10,000 times:

flutter pub get

Usage #

Caching Images #

The most common use case. Probably what you're here for.

CacheNetworkMediaWidget.img(
  url: 'https://example.com/image.png',
  width: 200,
  height: 200,
  fit: BoxFit.cover,
  placeholder: CircularProgressIndicator(),
)

SVG Graphics #

For when you need crisp graphics at any size.

CacheNetworkMediaWidget.svg(
  url: 'https://example.com/icon.svg',
  width: 100,
  height: 100,
  color: Colors.blue,
)

Lottie Animations #

Because your designer insisted on that fancy loading animation.

CacheNetworkMediaWidget.lottie(
  url: 'https://example.com/animation.json',
  width: 300,
  height: 300,
  repeat: true,
  animate: true,
)

Advanced Features #

Custom Cache Directory #

Want to control where we store your precious cached files? Sure.

CacheNetworkMediaWidget.img(
  url: 'https://example.com/image.png',
  cacheDirectory: Directory('/your/custom/path'),
)

Error Handling #

When things inevitably go wrong (network fails, server returns a 404, etc.):

CacheNetworkMediaWidget.img(
  url: 'https://example.com/image.png',
  errorBuilder: (context, error, stackTrace) {
    return Icon(Icons.broken_image);
  },
)

How It Works #

Simple: Download once, cache forever (or until you clear the cache). Each media type gets cached appropriately:

• Images & SVG: Binary cache files
• Lottie: JSON files (because parsing bytes into JSON just to parse them again is inefficient)

Cache hits are logged. Cache misses trigger downloads. It's not rocket science, but it works.

Documentation #

For those who actually read documentation:

• API Reference
• Architecture Details - For the curious developers
• Contributing Guidelines - For the brave souls

Performance #

Benchmarked? Not yet. Fast? Absolutely. Faster than downloading the same image 47 times? Definitely.

Contributing #

Found a bug? Have a feature request? Think you can make this better?

Read CONTRIBUTING.md first. Seriously, read it. We have standards.

License #

MIT License. Use it, abuse it, just don't blame us when your app breaks.

See LICENSE file for the legal stuff.

Author #

Created by @D-extremity - A developer who was tired of implementing the same caching logic for the 12th time.

GitHub: @D-extremity

Support #

If this package saved you time (and sanity), consider:

• Starring the repo on GitHub
• Telling your fellow developers
• Actually reading the documentation before opening issues

FAQ #

Q: Why another caching package?
A: Because existing solutions didn't handle SVG and Lottie the way we wanted.

Q: Is it production-ready?
A: Define "production." Use at your own risk.

Q: Can I use this in my enterprise app?
A: Sure, if your enterprise approves MIT-licensed packages.

Cache Network Media - Making network media caching less painful since 2025.