blackbox

Reactive state management core for Dart.

Boxes hold state. Graphs wire dependencies. No code generation. No boilerplate.

See the full documentation with examples: README

Quick Start

import 'package:blackbox/blackbox.dart';

class CounterBox extends NoInputBox<int> {
  int _value = 0;

  @override
  int compute(int? previous) => _value;

  void inc() => action(() => _value++);
}

API

Box Types

Graph

final graph = Graph.builder()
    .add(boxA)
    .add(boxB, input: (d) => d.whenReady(boxA))
    .build(start: true);

Persistence

BlackboxPersistence.init(store);
// Then use persistKey in any box constructor:
MyBox() : super(persistKey: 'my_key');

Lifecycle

• prepare(I input, O? previous) — called once before first compute
• dispose() — called by graph.dispose()
• action(() { ... }) — mutate state and trigger recomputation

License

MIT