Skip to main content
Version: latest

Maintenance Commands

reg​

fsda reg <module> -a <app> [--strict]

Registers a module into an app by generating wrapper files and injecting integration points.

What happens:

  • Generates module wrapper files in apps/<app>/lib/modules/<module>.
  • Injects managed module dependency entry in apps/<app>/pubspec.yaml.
  • Injects module integration snippets into app files based on template manifest:
    • DI wiring
    • route registration
    • l10n delegates
    • failure extension mapping
  • Prints affected paths summary.

Rerun behavior:

  • Existing wrapper files are skipped by default.
  • Existing equivalent injection snippets are not duplicated.

Strict mode behavior:

  • Fails if wrapper files already exist.
  • Fails if required target file or injection anchor is missing.

di​

fsda di <module> -a <app> [-f <feature>] [--strict]

Synchronizes module feature DI registrations into module DI wrapper.

What happens:

  • Scans all feature classes in module (or one feature if -f is provided) under datasource/repository/usecase/logic layers.
  • Targets app module DI file: apps/<app>/lib/modules/<module>/<module>_di.dart.
  • Creates per-feature DI method if missing (for example _walletDi).
  • Appends only missing registration lines for each scanned feature.
  • Injects missing call(s) to feature DI methods in register pipeline.
  • Prints affected paths summary.

This flow is incremental and idempotent:

  • existing custom code is preserved
  • only missing registrations are appended

Strict mode behavior:

  • Fails if DI method or register-call insertion cannot be applied safely.

rm-reg​

fsda rm-reg <module> -a <app>

Removes module registration and cleans injected references.

What happens:

  • Removes module dependency mapping from apps/<app>/pubspec.yaml.
  • Removes previously injected snippets from DI/route/l10n/failure files.
  • Deletes wrapper directory apps/<app>/lib/modules/<module>.
  • Prints affected paths summary.

Rerun behavior:

  • Missing targets are reported as skipped when already clean.

fix-import​

fsda fix-import [-m <module>] [-a <app>]

Runs automatic import ordering, unused import cleanup, and feature barrel export normalization.

What happens:

  • Runs dart fix --apply --code=directives_ordering --code=unused_import.
  • Reorders *_feature.dart exports into marker layers (// data, // domain, // logic, // ui) when possible.
  • Supports app and module target scopes.
  • Writes formatter/fix changes directly in selected target project(s).