Flutter Smart Cache Manager

A powerful and lightweight Flutter caching library with TTL support, cache policies, offline fallback, and background refresh.

Features

  • Automatic caching
  • Time-to-live (TTL) expiration
  • Multiple cache policies
  • Offline fallback support
  • Background refresh (stale-while-revalidate)
  • Lightweight and easy to integrate

Installation

Add dependency:

dependencies:
  flutter_smart_cache_manager: ^0.0.5

Install packages:

flutter pub get

Import

import 'package:flutter_smart_cache_manager/flutter_smart_cache_manager.dart';

Quick Start

Create cache manager:

final cache = CacheManager(
  MemoryStorage(),
);

Fetch data with caching:

final data = await cache.get<String>(
  key: "user_profile",
  fetcher: () async {
    await Future.delayed(Duration(seconds: 2));
    return "Vishal Raj";
  },
);

First request fetches from network. Next requests return cached response instantly.

Cache Policies

Available policies:

CachePolicy.networkOnly
CachePolicy.cacheOnly
CachePolicy.cacheFirst
CachePolicy.networkFirst
CachePolicy.staleWhileRevalidate

Example:

await cache.get(
  key: "products",
  policy: CachePolicy.cacheFirst,
  fetcher: api.getProducts,
);

TTL (Time To Live)

Cache automatically expires after TTL.

await cache.get(
  key: "user",
  ttl: Duration(minutes: 30),
  fetcher: api.fetchUser,
);

After 30 minutes, fresh data will be fetched.

Delete Cache

Delete specific key:

await cache.delete("user");

Clear all cache:

await cache.clear();

Example

final cache = CacheManager(MemoryStorage());

final users = await cache.get<List<String>>(
  key: "users",
  ttl: Duration(minutes: 10),
  fetcher: () async {
    return ["Alice", "Bob"];
  },
);

print(users);

Running Tests

flutter test

Roadmap

  • Hive storage support
  • Isar support
  • Dio interceptor
  • Cache analytics
  • Encryption
  • Disk persistence

Contributing

Contributions, issues, and feature requests are welcome.

License

MIT License

Libraries

flutter_smart_cache_manager
A lightweight Flutter caching library with TTL support, cache policies, and offline fallback.