keyring #

Umbrella package for the Dart keyring ecosystem. Re-exports core types from keyring_core and provides a convenience top-level API that delegates to a lazily-initialized global defaultStore.

Quick Start #

import 'package:keyring/keyring.dart';

void main() async {
  final entry = KeyringEntry('my-app', 'alice');
  await setPassword(entry, 's3cret');
  final password = await getPassword(entry);
  print(password); // s3cret
}

Platform Selection #

defaultStore is initialized once on first access:

• Web (dart2js / dart2wasm) — WebKeyringStore() (in-memory)
• Native (VM, AOT) — NativeKeyringStore() (Rust FFI)

Override with setDefaultStore():

setDefaultStore(WebKeyringStore()); // force in-memory

Convenience API #

All top-level functions delegate to defaultStore:

Re-exports #

The package re-exports these types from keyring_core:

• KeyringEntry
• KeyringException
• KeyringErrorType
• CredentialPersistence