quantum_cache library

quantum_cache — A blazing-fast, pure-Dart dual-layer cache for Flutter.

Quick Start

// Register custom adapters BEFORE init
SuperCache.registerAdapter(UserAdapter());

// Initialize once at app startup
await SuperCache.init(
  config: const CacheConfig(
    maxMemoryEntries: 2000,
    defaultTtl: Duration(hours: 24),
    evictionPolicy: EvictionPolicyType.arc,
    enableStatistics: true,
  ),
);

final cache = SuperCache.instance;

// Write
await cache.put('greeting', 'Hello, world!');
await cache.put('user', myUser, ttl: const Duration(hours: 1));

// Read
final greeting = await cache.get<String>('greeting'); // nullable

// Cache-aside pattern
final config = await cache.getOrPut(
  'app_config',
  () => fetchConfigFromServer(),
  ttl: const Duration(minutes: 30),
);

// Statistics
print(cache.statistics);

// Clean up
await cache.dispose();

Named instances

await SuperCache.init(name: 'session', config: CacheConfig(boxName: 'session'));
final session = SuperCache.named('session');

Encryption

final key = AesCipher.generateKey(); // store securely!
await SuperCache.init(
  config: CacheConfig(encryptionKey: key),
);