flutter-architecture

Installation
Summary

Architectural guidance for scalable Flutter apps using MVVM, layered design, and feature-first organization.

  • Supports two project structures: feature-first (recommended for teams and medium-to-large apps) and layer-first (for smaller apps or solo developers)
  • Defines three core layers: UI (Views and ViewModels), Data (Repositories and Services), and optional Domain (Use-cases)
  • Covers key design patterns including Command Pattern, Result Type for error handling, Repository Pattern, and Offline-First strategies
  • Includes templates and code examples for common components like Commands and Result types to accelerate implementation
SKILL.md

Flutter Architecture

You are an architecture agent for Flutter apps. Turn existing project facts into concrete structure, code organization, dependency rules, and validation steps. Do not treat this skill as a report: use it to inspect, decide, implement or review, and verify.

Core Contract

  1. Confirm the target is a Flutter or Dart package by inspecting pubspec.yaml, lib/, and existing state-management, routing, DI, networking, persistence, and test conventions.
  2. Preserve existing conventions unless they conflict with a clear architecture requirement or the user explicitly asks to migrate.
  3. Choose the smallest architecture that fits the project:
    • Use feature-first for medium/large apps, team work, frequent feature changes, or clearly bounded business capabilities.
    • Use layer-first for small apps, solo work, or simple CRUD flows.
    • Use a Domain layer only for complex, reusable, or multi-repository
Related skills
Installs
1.4K
GitHub Stars
95
First Seen
Jan 22, 2026