Skip to main content

brix_storage 1.0.0 copy "brix_storage: ^1.0.0" to clipboard
brix_storage: ^1.0.0 copied to clipboard

Safe local storage for Flutter apps – values and secrets with reinstall and broken-keystore handling, plus a ready-made brix session store.

brix_storage #

Local storage that gets the tricky parts right – plain values, secrets, and a ready-made session store for brix.

  • Values (shared_preferences) and secrets (flutter_secure_storage: Keychain / Keystore) behind one class.
  • Reinstall safe: iOS keeps Keychain items after the app is deleted – brix_storage wipes them on a fresh install, so nobody is logged in as the previous user.
  • Never crashes on a broken Keystore (Android after a backup restore): the read gives null, the error goes to onError.
  • Moves old plain-text secrets into secure storage on the first read.
  • Ready session store: BrixSessionStore is a complete brix AuthSessionStore – tokens and the remembered password as secrets, the user as JSON.

Install #

flutter pub add brix_storage

Use #

final storage = BrixStorage(onError: (error, stack) => log('storage: $error'));

await storage.write('locale', 'en');
await storage.writeJson('settings', {'darkMode': true});
await storage.writeSecret('token', token);   // Keychain / Keystore

final token = await storage.readSecret('token');      // cached in memory after the first read
final settings = await storage.readJson('settings');  // null if missing or broken

await storage.clear(); // everything, e.g. after deleting the account

Session store for brix flows #

final store = BrixSessionStore<User>(
  storage: storage,
  userToJson: (user) => user.toJson(),
  userFromJson: User.fromJson,
);

LoginFlow(provider: auth, store: store, navigator: nav, feedback: alerts);
Call Keeps
clearSession() (logout) "remember me"
clearAll() (account deleted) nothing

Moving from your own storage? Pass the keys you used so users stay logged in:

BrixSessionStore<User>(
  storage: BrixStorage(installMarkerKey: 'hasSecureData'),
  keys: const SessionKeys(token: 'apiToken', user: 'user_data'),
  userToJson: (user) => user.toJson(),
  userFromJson: User.fromJson,
);

Other backends #

ValueStore and SecretStore are small interfaces – plug in Hive, a file, or MemoryStore in tests:

final storage = BrixStorage(values: MemoryStore(), secrets: MemoryStore());

License #

MIT

0
likes
0
points
1.2k
downloads

Publisher

unverified uploader

Weekly Downloads

Safe local storage for Flutter apps – values and secrets with reinstall and broken-keystore handling, plus a ready-made brix session store.

Repository (GitHub)
View/report issues

Topics

#storage #secure-storage #shared-preferences #authentication

License

unknown (license)

Dependencies

brix, flutter, flutter_secure_storage, shared_preferences

More

Packages that depend on brix_storage