ComposerCycleManager class

Orkitt Lifecycle Manager

A reusable singleton to observe app lifecycle changes across your app.

Example usage:

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  ComposerCycleManager().startObserving();
  runApp(const MyApp());
}

class MyHomePage extends StatefulWidget { ... }

class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();

    context.addLifecycleManager
      ..onAppResumed = _handleResumed
      ..onAppPaused = _handlePaused
      ..onAppInactive = _handleInactive
      ..onAppDetached = _handleDetached;
  }

  void _handleResumed() {
    debugPrint('✅ App resumed: refresh data, check token.');
  }

Key features:

  • Singleton pattern: always the same instance.
  • Attach callbacks anywhere with context.addLifecycleManager.
  • Works well with Riverpod if you wrap it in a provider.
  • Ideal for analytics, saving state, or handling background/foreground logic.
Mixed-in types

Constructors

ComposerCycleManager()
Factory constructor to get the same singleton every time.
factory

Properties

hashCode → int
The hash code for this object.
no setterinherited
onAppDetached ↔ void Function()?
Callback when the app is detached (terminated).
getter/setter pair
onAppHidden ↔ void Function()?
Callback when the app is hidden.
getter/setter pair
onAppInactive ↔ void Function()?
Callback when the app becomes inactive.
getter/setter pair
onAppPaused ↔ void Function()?
Callback when the app is paused (backgrounded).
getter/setter pair
onAppResumed ↔ void Function()?
Callback when the app comes back to foreground.
getter/setter pair
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

didChangeAccessibilityFeatures() → void
Called when the system changes the set of currently active accessibility features.
inherited
didChangeAppLifecycleState(AppLifecycleState state) → void
Internal Flutter callback when lifecycle state changes.
override
didChangeLocales(List<Locale>? locales) → void
Called when the system tells the app that the user's locale has changed. For example, if the user changes the system language settings.
inherited
didChangeMetrics() → void
Called when the application's dimensions change. For example, when a phone is rotated.
inherited
didChangePlatformBrightness() → void
Called when the platform brightness changes.
inherited
didChangeTextScaleFactor() → void
Called when the platform's text scale factor changes.
inherited
didChangeViewFocus(ViewFocusEvent event) → void
Called whenever the PlatformDispatcher receives a notification that the focus state on a view has changed.
inherited
didHaveMemoryPressure() → void
Called when the system is running low on memory.
inherited
didPopRoute() → Future<bool>
Called when the system tells the app to pop the current route, such as after a system back button press or back gesture.
inherited
didPushRoute(String route) → Future<bool>
Called when the host tells the application to push a new route onto the navigator.
inherited
didPushRouteInformation(RouteInformation routeInformation) → Future<bool>
Called when the host tells the application to push a new RouteInformation and a restoration state onto the router.
inherited
didRequestAppExit() → Future<AppExitResponse>
Called when a request is received from the system to exit the application.
inherited
handleCancelBackGesture() → void
Called when a predictive back gesture is canceled, indicating that no navigation should occur.
inherited
handleCommitBackGesture() → void
Called when a predictive back gesture is finished successfully, indicating that the current route should be popped.
inherited
handleStartBackGesture(PredictiveBackEvent backEvent) → bool
Called at the start of a predictive back gesture.
inherited
handleStatusBarTap() → void
Called when the user taps the status bar on iOS, to scroll a scroll view to the top.
inherited
handleUpdateBackGestureProgress(PredictiveBackEvent backEvent) → void
Called when a predictive back gesture moves.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
startObserving() → void
Start observing lifecycle changes.
stopObserving() → void
Stop observing lifecycle changes.
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited