[assets/statepulse_logo.png]

StatePulse

A lightweight, reactive, hydrated state-management library for Flutter — inspired by Provider + Hydrated Bloc, but 10× simpler.

🚀 Features #

• 🌊 Simple API — only a few core classes
• 🔥 Ultra-fast UI updates (InheritedNotifier + AnimatedBuilder)
• 💾 Built-in hydration using HydratedStatePulse
• 🎯 Selectors, Listeners, and Consumers (like Bloc/Provider)
• 🧩 Supports local store instances (per-widget state)
• ⚡ Zero boilerplate
• 🟦 Zero dependencies (only shared_preferences for persistence)
• 🧠 Designed for small → large production apps

📦 Install #

dependencies:
  state_pulse: ^0.0.5

🧩 Quick Start Example

1. Create a Store class CounterStore extends ChangeNotifier with HydratedStatePulse { int value = 0;

void increment() { value++; notifyListeners(); }

@override String get storageKey => 'counter_store';

@override Map<String, dynamic> toJson() => {'value': value};

@override void fromJson(Map<String, dynamic> json) { value = json['value'] ?? 0; } }

2. Provide the Store StatePulseProvider( store: CounterStore(), child: MyApp(), );

3. Use With Builder StatePulseBuilder

🎯 Selector Example (High Performance Rebuilds)

Only rebuilds when the selected value changes.

StatePulseSelector<CounterStore, int>( selector: (store) => store.value, builder: (_, value) => Text('$value'), );

👂 Listener Example (Side-effects — No UI Rebuild) StatePulseListener

🔀 Consumer Example (Listener + Builder) StatePulseConsumer

🧪 Local Store Instance (Widget-Scoped State)

Each widget has its own isolated store:

final localStore = CounterStore();

StatePulseBuilder

🔧 Advanced Example — Hydrated User Store class UserStore extends ChangeNotifier with HydratedStatePulse { UserModel? user; bool loading = false;

Future

@override String get storageKey => "user_store";

@override Map<String, dynamic> toJson() => user == null ? {} : {"user": user!.toJson()};

@override void fromJson(Map<String, dynamic> json) { if (json["user"] != null) { user = UserModel.fromJson(json["user"]); } } }

📁 Folder Structure state_pulse/ ├─ assets/ │ └─ statepulse_logo.png ├─ lib/ │ ├─ state_pulse.dart │ ├─ src/ │ │ ├─ hydrated_state_pulse.dart │ │ ├─ state_pulse_provider.dart │ │ ├─ state_pulse_builder.dart │ │ ├─ state_pulse_selector.dart │ │ ├─ state_pulse_listener.dart │ │ └─ state_pulse_consumer.dart ├─ example/ ├─ CHANGELOG.md ├─ README.md └─ pubspec.yaml