flutter-getx-state-management

name	flutter-getx-state-management
description	Implement reactive state with GetX controllers, bindings, and observables in Flutter. Use when managing app state with GetxController, Obx, GetBuilder, or dependency lifecycle—not unit tests for existing controllers.
metadata	{"triggers":{"files":["**_controller.dart","**/bindings/*.dart"],"keywords":["GetxController","Obx","GetBuilder",".obs","Get.put","Get.find","Get.lazyPut"]}}

GetX State Management

Priority: P0 (CRITICAL)

Structure

lib/app/modules/home/
├── controllers/
│   └── home_controller.dart
├── bindings/
│   └── home_binding.dart
└── views/
    └── home_view.dart

Implementation Guidelines

• Controllers: Extend GetxController. Store logic and state variables here.
• Reactivity:
• Use .obs for observable variables (e.g., final count = 0.obs;).
• Wrap UI in Obx(() => ...) to listen for changes.
• For simple state, use update() in controller and GetBuilder in UI.
• Dependency Injection:
• Bindings: Use Bindings class to decouple DI from UI.
• Lazy Load: Prefer Get.lazyPut(() => Controller()) in Bindings.
• Lifecycle: Let GetX handle disposal. Avoid permanent: true.
• Hooks: Use onInit(), onReady(), onClose() instead of initState/dispose.
• Architecture: Use get_cli for modular MVVM (data, models, modules).

Anti-Patterns

• Ctx in Logic: Pass no BuildContext to controllers.
• Inline DI: Avoid Get.put() in widgets; use Bindings + Get.find.
• Fat Views: Keep views pure UI; delegate all logic to controller.

Code Example

See references/controller-example.md for controller + view implementation pattern.

Related Topics

getx-navigation | layer-based-clean-architecture | dependency-injection

Controller boundary

• Keep BuildContext out of controllers. Use GetX services such as Get.snackbar for controller-owned feedback and expose reactive state to the view.

Remediation anchors

• Remediation anchors: onInit, Obx, no BuildContext in the controller