name: flutter-architecture
description: Flutter app architecture skill hub: feature structure, clean architecture boundaries, dependency injection, repositories, DTO vs entity, and error modeling.
Skill: Architecture (Boundaries, Dependencies, Errors)
Purpose
Architecture keeps complexity manageable: clear boundaries between UI, domain rules, and data/platform details.
This hub routes common architecture topics for Flutter apps.
When to use
- The codebase is inconsistent across features.
- UI, data, and business logic are tightly coupled.
- You need dependency injection or a repository layer.
When NOT to use
- Do not over-architect small apps; start simple and add boundaries when needed.
Core concepts
- Boundaries: where responsibilities change.
- Dependency direction: higher layers depend on lower-level abstractions.
- Error contracts: failures modeled consistently.
Recommended patterns
- Use feature-first structure.
- Put interfaces in the domain layer.
- Keep DTOs in data layer; map to domain entities.
Minimal example
Where to go next:
- Folder/module consistency -> feature_structure.md
- Layering and boundaries -> clean_architecture.md
- Dependency injection -> dependency_injection.md
- Repository abstraction -> repository_pattern.md
- DTO vs entity mapping -> dto_vs_entity.md
- Typed failures -> error_modeling.md
Edge cases
- Multi-brand/white-label needs config injection.
- Offline-first needs explicit caching and invalidation.
Common mistakes
- Leaking API response shapes into UI.
- Circular dependencies between features.
Testing strategy
- Unit test domain logic.
- Contract test repository behavior with canned data.
Related skills
