🔥 Firelive

Firelive is a lightweight, real-time Firebase Firestore state management solution using Flutter’s ValueNotifier. It offers two versions — V1 with advanced state handling, and V2 for minimal, fast use. Built for developers who want full control and performance without heavyweight state management libraries.

✨ Features

  • 📡 Real-time Firestore collection updates
  • ⚡ ValueNotifier-based reactivity (simple, fast)
  • 🧭 Two versions: Full (V1) and Lite (V2)
  • 🐛 Built-in error and loading state (V1)
  • ⏸️ Pause/resume stream manually (V1)
  • 🎯 Great for Firebase-powered Flutter apps (web, mobile, desktop)

🔀 Versions

🔹 FirestoreLiveListV1

Includes loading, error, pause/resume, and real-time updates.

final users = FirestoreLiveListV1<UserModel>(
  path: 'users',
  queryBuilder: (col) => col.orderBy('created_at'),
  fromMap: (data, id) => UserModel.fromMap(data, id),
);

await users.listen();

Use in a widget:

ValueListenableBuilder(
  valueListenable: users.notifier,
  builder: (_, list, __) => ListView(
    children: list.map((e) => Text(e.name)).toList(),
  ),
);

Cleanup:

await users.dispose();

🔹 FirestoreLiveListV2

A minimal, fast version without loading/error/pause support.

final users = FirestoreLiveListV2<UserModel>(
  collection: 'users',
  queryBuilder: (col) => col.where('active', isEqualTo: true),
  fromMap: (data) => UserModel.fromMap(data),
);

await users.listen();

📁 File Structure

lib/
├── firelive.dart           # Export both V1 and V2
└── src/
    ├── firestore_live_list_v1.dart
    └── firestore_live_list_v2.dart

🧪 Example

Use the /example directory to try Firelive with a real Firebase setup.

🛠 Installation

Add to your Flutter project:

dependencies:
  firelive: ^0.0.1

👨‍💻 Author

Mohamed Razan
🚀 Flutter & Firebase Developer
📧 mohamedrazanr@gmail.com
🐙 GitHub: github.com/Mohamedrazan
💼 LinkedIn: linkedin.com/in/mohamed-razan-35b073245

🪪 License

MIT License — free to use, modify, distribute, and contribute.

🤝 Contributions

Contributions and feedback welcome! Submit an issue or PR on GitHub.

Built with simplicity and performance in mind — no Provider, Bloc, or Riverpod needed.

Libraries

example/main
firelive