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)
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
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.