nylo-state-management

Nylo State Management

Overview

Nylo v7 state management is built on two core classes: NyState (for reusable widgets) and NyPage (for pages, extending NyState). State updates propagate through named state identifiers, state actions enable cross-widget communication, and the provider/event systems handle app-level initialization and event-driven logic. Decoders bridge API responses to typed models.

When to Use

• Building stateful widgets that need to update from external triggers
• Managing page lifecycle (init, loading, reboot)
• Communicating between widgets via state actions
• Locking UI during async operations (e.g. preventing double-submit)
• Registering app services and packages via providers
• Dispatching and listening to application events
• Registering model decoders for API response parsing
• When NOT to use: for simple local state within a single widget, standard Flutter setState is sufficient

Quick Reference

Task	Code
Create stateful widget	metro make:stateful_widget my_widget
Create state-managed widget	metro make:state_managed_widget cart
Update a widget's state	updateState(Cart.state)
Update with data	updateState(Cart.state, data: "value")
Fire a state action	stateAction('refresh', state: MyWidget.state)
Lock during async	lockRelease('key', perform: () async { ... })
Check if locked	isLocked('key')
Check if loading	isLoading(name: 'key')
Reboot page init	reboot()
Create provider	metro make:provider cache_provider
Create event	metro make:event payment_event
Dispatch event	event<PaymentEvent>(data: {...})

NyState

Basic Structure

class MyWidget extends StatefulWidget {
  static String state = "my_widget";

  @override
  _MyWidgetState createState() => _MyWidgetState();
}

class _MyWidgetState extends NyState<MyWidget> {
  _MyWidgetState() {
    stateName = MyWidget.state;
  }

  @override
  get init => () async {
    // Async initialization - loader shown automatically
  };

  @override
  void stateUpdated(data) {
    // Called when updateState(MyWidget.state) is invoked
    reboot(); // Re-run init to refresh data
  }

  @override
  Widget view(BuildContext context) {
    return Scaffold(
      body: Text("My Widget"),
    );
  }
}