buoy_storage

Buoy storage inspector for Flutter — browse and monitor shared_preferences (plus optional secure / MMKV backends) in an in-app panel that streams live to Buoy Desktop.

Part of the Buoy devtools suite. Ports @buoy-gg/storage 1:1: the same browser / events tabs, filters, storage keys, and sync protocol.

Usage

Zero-config via the umbrella:

import 'package:buoy/buoy.dart';

MaterialApp(
  builder: (context, child) =>
      BuoyDevTools(child: child ?? const SizedBox.shrink()),
);

Or register the tool directly:

import 'package:buoy_storage/buoy_storage.dart';

if (kDebugMode) registerBuoyStorage();

Live monitoring

shared_preferences has no change stream, so Buoy monitors writes two ways:

1. Owned writes — use BuoyPrefs instead of SharedPreferences for writes you want reflected instantly in the Events stream.
2. Poll/diff — while monitoring is on, Buoy snapshots and diffs all keys on a timer so writes made through any path still surface.

Secure / MMKV (optional)

No native storage deps are pulled by default. Register a backend to expose it:

registerBuoySecureBackend(mySecureBackend);
registerBuoyMmkvBackend(myMmkvBackend);

License

See buoy.gg. Proprietary — © Buoy.