modularity_flutter #

Flutter integration for the Modularity framework.

Features #

• ModularityRoot: InheritedWidget that holds the DI container factory and module registry.
• ModuleScope: Scopes dependencies to a specific part of the widget tree.
• ModuleProvider: Provides access to dependencies in the widget tree.
• RouteObserver: Automatically handles module lifecycle based on navigation.

Usage #

Wrap your application in ModularityRoot:

void main() {
  runApp(
    ModularityRoot(
      child: MyApp(),
    ),
  );
}

Use ModuleScope to define a module for a subtree:

class FeaturePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ModuleScope(
      module: FeatureModule(),
      child: FeatureView(),
    );
  }
}

Advanced ModuleScope options #

• retentionPolicy / retentionKey let you opt into KeepAlive or custom retention strategies without wiring your own navigator hooks.
• overrideScope allows you to pass a ModuleOverrideScope tree that only affects the current module and its imports (useful for temporary test overrides or dynamic feature flags).