architecture-feature-first

What problem does it solve?

Organizes Flutter projects using a feature-first, layered architecture that clearly separates UI, business logic, and data concerns for scalable, maintainable codebases.

Core Features & Use Cases

• Feature-centric directory structure: group all layers of a feature together in a single directory to simplify navigation and collaboration.
• Clear layer responsibilities and data flow: UI components, a business-logic holder (ViewModel/Cubit/Controller/Provider), and data repositories/services with unidirectional data flow.
• State-management agnostic: supports Bloc/Cubit, Provider, Riverpod, or other state-management approaches without enforcing a specific pattern.
• Dependency injection guidance: demonstrates how to wire dependencies across layers for testability and flexibility.

Quick Start

Create a new feature directory and organize its UI, logic, and data files under that directory following the feature-first structure.