🚀 Stream Value

Stream Value is a simple and lightweight state management solution for Flutter that wraps StreamController and StreamBuilder to eliminate boilerplate.

Unlike other packages, stream_value is focused purely on state. It does not include dependency injection—staying true to the single responsibility principle.

✨ Features

✅ Minimal Boilerplate — Use streams with ease
🎯 Focused State Management — No DI, just state
⚡ Lightweight & Simple — Easy to learn and integrate
🛡️ Null-Safety by Default — Handles nullable & non-nullable types
🧩 Built-in Error Handling — Show error widgets with ease

🛠 Getting Started

📦 Installation

Add to your pubspec.yaml:

dependencies:
  stream_value: ^0.0.5  # Check for the latest version

Then run:

flutter pub get

💡 Usage

The package provides two main classes:

StreamValue

StreamValueBuilder

✅ 1. Create a StreamValue

final nameStream = StreamValue<String?>(); // Nullable
final counterStream = StreamValue<int>(defaultValue: 0); // Non-nullable

🔄 2. Update the Value

void updateName(String newName) {
  nameStream.addValue(newName);
}

void incrementCounter() {
  final currentCount = counterStream.value;
  counterStream.addValue(currentCount + 1);
}

🧱 3. Build Your UI

class CounterPage extends StatelessWidget {
  final counterStream = StreamValue<int>(defaultValue: 0);

  CounterPage({super.key});

  void _increment() {
    counterStream.addValue(counterStream.value + 1);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('StreamValue Example')),
      body: Center(
        child: StreamValueBuilder<int>(
          streamValue: counterStream,
          builder: (context, value) {
            return Text(
              'You have pushed the button this many times: $value',
              style: Theme.of(context).textTheme.headlineMedium,
            );
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _increment,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

❗ Handling Null & Error States

StreamValueBuilder<User?>(
  streamValue: userStream,
  onNullWidget: const Center(child: CircularProgressIndicator()),
  onErrorBuilder: (error) => Center(child: Text('Error: $error')),
  builder: (context, user) {
    return Text('Hello, ${user.name}');
  },
),

🧪 Verified Source Details

✅ StreamValue

Uses StreamController
Supports null safety and default values
Provides .value and .error access
Handles manual error injection via addError(...)
.dispose() safely closes both controllers

Rebuilds using StreamBuilder
Supports:
onNullWidget
onErrorBuilder
Default builder
Works with nullable and non-nullable streams

🤝 Contributing

Contributions are welcome! This package focuses on simplicity. Please keep PRs in line with the existing lightweight architecture.

Fork it 🍴
Create your feature branch 🚀
Push & open a PR ✅
Before adding a major feature, open an issue to discuss it.

📄 License

MIT License. See the LICENSE file for full details.

🔗 Links

View on Pub.dev →

GitHub Repo →