flutter_base_structure

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.

Writes unit and widget tests for blocs, repositories, and screens using bloc_test + mocktail

Implements BLoC state management using CoreBlocBase, an abstract State hierarchy, and a freezed _StateData

Handles cross-feature BusEvent communication with EventBusManager in the Flutter base template

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)

Reviews data-layer changes — Freezed DTOs, Retrofit clients, the storage seam, optional hive_ce stores, and repositories — against the template's conventions

Routes thrown errors through CoreBlocBase + CoreDelegate to StateBase's ErrorType-driven dialog/snackbar/login UI rather than a custom Failure type

Extracts screen handlers and bloc listeners into a part-of "*.action.dart" extension file

Adds and updates app strings through the CSV → ARB → generated localizations workflow

Configures routes with the IRoute / CustomRouter abstractions in core and exposes navigation via a BuildContext coordinator

Applies the fl_theme design system via context.themeColor and context.textTheme without hard-coded colors or Material text-style names

Creates and runs previews with Flutter's official Widget Previewer using `@Preview` from `package:flutter/widget_previews.dart`. Use when the user asks to preview, showcase, inspect, or smoke-test a Flutter widget in the Widget Previewer.