flutter_official_architecture

Expert guidance for `build_runner 2.13.x` in this repository. Covers adopting code generation safely in a project that currently has no `build_runner`, no `build.yaml`, and no checked-in generated files. Use when adding builders such as `json_serializable`, `freezed`, `mockito`, `go_router_builder`, or similar; configuring `build.yaml`; running `build` or `watch`; handling generated outputs; or debugging codegen issues without breaking this project's architecture.

Expert guidance for `flutter_bloc 9.1.x`, `bloc 9.x`, and `bloc_test 10.x` in this repository. Covers Cubit vs Bloc, BlocProvider and RepositoryProvider, BlocBuilder, BlocListener, BlocConsumer, BlocSelector, BlocObserver, and testing with bloc_test. Use when adopting flutter_bloc, introducing bloc-based presentation state, testing blocs/cubits, or deciding how bloc fits this project's existing get_it plus view-model architecture.

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific functionality.

Sets up a Linux environment for Flutter development. Use when configuring a Linux machine to run, build, or deploy Flutter applications.

Sets up a macOS environment for Flutter development. Use when configuring a macOS machine to run, build, or deploy Flutter applications for iOS or macOS.

Sets up a Windows environment for Flutter development. Use when configuring a Windows machine to run, build, or deploy Flutter applications for Windows desktop or Android.

Implements unit, widget, and integration tests for a Flutter app. Use when ensuring code quality and preventing regressions through automated testing.

Expert guidance on Dio 5.9.x for Dart and Flutter. Covers singleton setup with BaseOptions, request methods, interceptors, QueuedInterceptor, timeout and cancellation, FormData uploads, adapters, certificate pinning, error handling with DioException, testing, and production integration in this repository. Use when working with Dio, HTTP clients, interceptors, request configuration, uploads, downloads, transport errors, or API service-layer code.

Architecture guidance for this Flutter project. Covers the actual layered structure used here: dependency injection with get_it in `lib/injector.dart`, startup readiness in `lib/main.dart`, service abstractions under `lib/data/services`, local and remote repository implementations under `lib/data/repositories`, use cases returning `Result` under `lib/domain/use_cases`, and UI/view-model integration with `Command` under `lib/ui`. Use when designing features, placing code in the correct layer, wiring dependencies, or extending this repository without breaking its architecture.

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

Master Flutter development with Dart 3, advanced widgets, and multi-platform deployment.

Expert guidance on get_it service locator and dependency injection for Flutter/Dart. Covers registration (singleton, factory, lazy, async), scopes with shadowing, async initialization with init() pattern, retrieval, testing with scope-based mocking, and production patterns. Use when working with get_it, dependency injection, service registration, scopes, or async initialization.

Expert guidance for `go_router 17.x` in this repository. Covers the actual routing architecture used here: a single router in `lib/routing/router.dart`, centralized path constants in `lib/routing/routes.dart`, route builders that resolve screen dependencies through `GetIt`, navigation with `context.push` and `context.pop`, and passing typed route payloads through `state.extra`. Use when adding screens, changing navigation flows, wiring route arguments, or implementing redirects without breaking this project's routing conventions.

Expert guidance for `package:logging 1.3.x` in this repository. Covers the actual logging setup used here: root log level configuration in `lib/main.dart`, class-scoped `Logger('<ClassName>')` usage in view models, choosing levels such as `fine` and `warning`, and adding a root log handler when operational output is needed. Use when adding diagnostics, standardizing log messages, wiring global log sinks, or improving observability without breaking this project's architecture.

Expert guidance for `shared_preferences 2.5.x` in this repository. Covers the actual storage architecture used here: asynchronous `SharedPreferences` registration in `lib/injector.dart`, startup readiness in `lib/main.dart`, and access only through the `LocalStorage` abstraction in `lib/data/services/local_storage`. Use when adding lightweight persistence, evolving the local storage service, or deciding whether to stay on legacy `SharedPreferences` or migrate to `SharedPreferencesAsync` or `SharedPreferencesWithCache`.