Menu
Runs build_runner across core, data_source, and apps/main via the makefile after edits to freezed/injectable/retrofit sources (and the optional Hive type adapters)
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Behavioral guidelines for Flutter base tasks: clarify ambiguity, keep changes simple and surgical, and define verifiable success criteria before coding.
Scaffolds a new feature module under apps/main/lib/presentation/modules using the bundled module generator
Reviews UI-layer changes — screens, blocs, widgets, routes — against the template's StateBase + CoreBlocBase + fl_theme conventions
Awareness index of every reusable widget in fl_ui, fl_theme, fl_media, and core's common_widget — name, one-line purpose, when to reach for it instead of writing a new one
Builds the data layer with Freezed DTOs, Retrofit clients, the storage-seam local data manager, and repositories wired through injectable
Teaches and applies Flutter/Dart dependency injection with Injectable + GetIt, grounded in this repo's Clean Architecture and code generation conventions. Use when changing DI wiring, adding BLoCs/use cases/repositories/modules, using @Named/@preResolve/@factoryParam/env registrations, reviewing DI best practices, or setting up DI tests.
| name | fl-code-generation |
| description | Runs build_runner across core, data_source, and apps/main via the makefile after edits to freezed/injectable/retrofit sources (and the optional Hive type adapters) |
| license | MIT |
| metadata | {"audience":"flutter-developers","framework":"flutter","pattern":"code-generation"} |
After editing any file annotated with @freezed, @JsonSerializable/@JsonKey, @Injectable/@LazySingleton/@Singleton/@module, @RestApi, @FlRouteProvider, the optional @HiveType, or that declares a _StateData for a bloc.
The makefile is the canonical interface. It auto-detects fvm if present and falls back to the system Flutter SDK.
| Command | What it runs |
|---|---|
make gen_all | gen_core → gen_data_source → gen_main (full graph) |
make gen_main | build_runner build only inside apps/main/ |
make gen_core | build_runner build only inside core/ |
make gen_data_source | build_runner build only inside modules/data_source/ |
make gen | Interactive picker for the same targets |
make lang | Regenerates app_localizations_*.dart from localizations.csv |
make asset | Regenerates the asset accessor under each package |
make format | dart format . across the repo |
make pub_get | pub get across plugins, core, main |
When you don't know the scope of your change, run make gen_all. It's slower but never wrong.
| Pattern | Producer | Hand-edit? |
|---|---|---|
*.freezed.dart | freezed | Never |
*.g.dart | json_serializable, retrofit (and hive_ce, when used) | Never |
*.config.dart | injectable | Never |
app_localizations*.dart | flutter intl tooling via make lang | Never |
All generated files are committed to source control — CI does not regenerate them.
dart run build_runner clean from inside the failing package, then re-run make gen_<scope>.part directive — every freezed/json/retrofit source needs the matching part 'foo.freezed.dart'; / part 'foo.g.dart';.sealed — freezed unions and the bloc _StateData require sealed class.@Default(...) — non-nullable fields without a default break codegen.--delete-conflicting-outputs; if you're invoking dart run build_runner directly, do the same.Useful while iterating on a single package:
cd apps/main
fvm dart run build_runner watch --delete-conflicting-outputs # or `dart run …` if no fvm
Stop with Ctrl-C. Don't leave it running in CI.
For a pre-commit/CI gate, run make gen_all and then assert that no generated artifacts changed:
make gen_all
git diff --exit-code -- '**/*.freezed.dart' '**/*.g.dart' '**/*.config.dart' \
'apps/main/lib/l10n/generated/**'
@freezed/@Injectable/@RestApi/@FlRouteProvider/(optional @HiveType) source, make gen_all (or the narrow target) was run.localizations.csv, make lang was run.dart run build_runner build without --delete-conflicting-outputs and stopping at the first conflict.*.freezed.dart to silence an analyzer warning — fix the source instead.make gen_main does not touch core/ or modules/data_source/. When core types change, run make gen_all.