nylo-storage

Nylo Storage

Overview

Nylo v7 provides three storage mechanisms: NyStorage for secure persistent storage (backed by flutter_secure_storage), Backpack for fast in-memory synchronous access, and cache() for time-based caching. They can be combined for hybrid patterns where data is persisted and also available synchronously.

When to Use

• Persisting data across app restarts (NyStorage)
• Fast synchronous reads during runtime (Backpack)
• Caching API responses or computed data with expiration (cache)
• Storing collections/lists of items
• Managing temporary session data (sessions)
• Dual storage: persistent + in-memory access
• When NOT to use: For authentication data specifically, use nylo-auth; for API response caching, see nylo-networking

Quick Reference

Action	Code
Save to storage	await NyStorage.save("key", value)
Read from storage	await NyStorage.read<String>("key")
Delete from storage	await NyStorage.delete("key")
Save JSON	await NyStorage.saveJson("key", map)
Read JSON	await NyStorage.readJson("key")
Save with TTL	await NyStorage.saveWithExpiry("key", val, ttl: Duration(hours: 1))
Save to Backpack	backpackSave("key", value)
Read from Backpack	backpackRead<String>("key")
Save to both	await NyStorage.save("key", value, inBackpack: true)
Cache with expiry	await cache().saveRemember("key", 300, () async => data)
Cache forever	await cache().saveForever("key", () async => data)
Read cache	await cache().get<String>("key")
Clear cache	await cache().clear("key")
Add to collection	await NyStorage.addToCollection("key", item: value)
Read collection	await NyStorage.readCollection<String>("key")

NyStorage (Persistent Storage)

Stores data securely on device using flutter_secure_storage under the hood.

Basic Operations

// Save
await NyStorage.save("coins", 100);
await NyStorage.save("username", "Anthony");

// Read with type
int? coins = await NyStorage.read<int>("coins");
String? username = await NyStorage.read<String>("username");

// Read with default value
String name = await NyStorage.read("name", defaultValue: "Guest") ?? "Guest";

// Delete
await NyStorage.delete("username");
await NyStorage.deleteMultiple(["key1", "key2", "key3"]);
await NyStorage.deleteAll();
await NyStorage.deleteAll(excludeKeys: ["auth_token"]);