# Project Structure Flutter

> Flutter/Mobile Layout

- Skill: `irahardianto/project-structure-flutter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add irahardianto/project-structure-flutter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/irahardianto/project-structure-flutter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: irahardianto (https://skillmd.com/u/irahardianto)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/irahardianto/project-structure-flutter

---


## Flutter/Mobile Layout

Vertical slice — features are self-contained modules.

```
apps/
  mobile/
    lib/
      core/                         # Foundation
        network/
          api_client.dart           # Dio/http with base config
          api_interceptor.dart      # Auth, logging interceptors
        storage/
          local_storage.dart        # SharedPreferences/Hive wrapper
        theme/
          app_theme.dart            # ThemeData, color schemes
          app_typography.dart       # TextStyles, font families
        router/
          app_router.dart           # GoRouter config (@riverpod)
          app_router.g.dart         # Generated
        constants/

      features/                     # Vertical slices
        task/
          screens/
            task_list_screen.dart    # Route target (ConsumerWidget)
            task_detail_screen.dart
          widgets/
            task_card.dart
            task_form.dart
          state/
            task_notifier.dart       # @riverpod class
            task_notifier.g.dart     # Generated
            task_state.dart          # freezed state classes
          models/
            task.dart               # freezed domain model
            task.g.dart             # json_serializable
            task.freezed.dart       # freezed
          logic/
            task_logic.dart         # Pure business rules
          repository/
            task_repository.dart    # Abstract interface
            task_repository_impl.dart
            task_repository_mock.dart
          api/
            task_api.dart           # REST calls (Dio)
        auth/
        settings/

      shared/                       # Cross-feature, NO domain logic
        widgets/
          app_button.dart
          app_text_field.dart
          loading_indicator.dart
        utils/
          date_formatter.dart
          validators.dart
        models/
          api_response.dart
          pagination.dart

    test/                           # Mirrors lib/ layout
      features/
        task/
          state/task_notifier_test.dart
          logic/task_logic_test.dart
          widgets/task_card_test.dart
          api/task_api_test.dart
      integration_test/
        task_flow_test.dart

    pubspec.yaml
    analysis_options.yaml           # Includes riverpod_lint
```

Key differences from web: `screens/` = views, `widgets/` = components, `state/` = Riverpod 3, `repository/` = data + cache. `ProviderScope` at root for DI (no manual locator). `*.g.dart`/`*.freezed.dart` = codegen artifacts. Tests in `test/` mirroring `lib/` (Flutter convention). Naming: `*_test.dart` (unit), `*_integration_test.dart` (integration).

### Related
- Project Structure GEMINI.md § Project Structure
- Flutter Idioms and Patterns @.gemini/skills/flutter-idioms/SKILL.md