flutter_safe_async #

🛡️ flutter_safe_async is a lightweight Flutter package that eliminates the most common runtime crash:

❌ setState() called after dispose()

It provides lifecycle-aware async handling for Future, Timer, and Stream operations in Flutter widgets — with zero boilerplate.

🔥 The Problem (Very Common in Flutter) #

In Flutter, asynchronous operations often outlive the widget that started them.

Typical scenarios:

• API call finishes after user leaves the screen
• Timer.periodic keeps running in background
• StreamSubscription continues emitting values

This results in:

• ❌ App crashes
• ❌ Memory leaks
• ❌ Unstable UI behavior

✅ The Solution #

flutter_safe_async binds async operations to the widget lifecycle.

It ensures:

• UI updates only happen while the widget is alive
• Timers and streams are cleaned up automatically
• Async errors don’t trigger invalid callbacks

✨ Features #

• ✅ Safe replacement for setState
• ✅ Automatically cancels Timer & Timer.periodic
• ✅ Automatically cancels StreamSubscription
• ✅ Lifecycle-safe Future execution
• ✅ Built-in retry support for async tasks
• ✅ No dependency on state management libraries
• ✅ Works with any architecture
• ✅ Production-ready & beginner-friendly

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  flutter_safe_async: ^1.0.1