flutter-best-arch
npx skills add https://github.com/nadveos/flutter-best-arch --skill flutter-best-arch
Agent 安装分布
Skill 文档
Skill: Flutter App Real Architecture (Riverpod)
Objetivo
Desarrollar aplicaciones Flutter reales, escalables y multiplataforma siguiendo Clean Architecture adaptada a Flutter.
Estructura obligatoria
lib/ âââ config/ â âââ router/ â âââ themes/ â âââ environment/ â âââ platform/ â âââ domain/ â âââ datasources/ # Contratos (abstract) â âââ models/ # Modelos de negocio PUROS â âââ repositories/ # Interfaces â âââ infrastructure/ â âââ datasources/ # Firebase / API / DB â âââ entities/ # DTOs / modelos persistencia â âââ mappers/ # Entity <-> Domain â âââ repositories/ # Implementaciones â âââ presentation/ â âââ screens/ â âââ widgets/ â âââ providers/ # Riverpod â âââ services/ # Helpers UI (NO lógica negocio) â âââ l10n/ âââ app_en.arb âââ app_es.arb
State Management
- Riverpod obligatorio
- Providers por feature
- UI reactiva, sin lógica de negocio
Reglas de dependencias
- presentation â domain
- infrastructure â domain
- domain NO depende de nadie
- Widgets NO llaman repositorios
Backend
- Repositorios abstractos en domain
- Implementaciones intercambiables:
- Firebase
- PocketBase
- REST API
Multiplataforma
- NO usar dart:io directamente
- Usar adaptadores de plataforma
- Responsive obligatorio (mobile/web/desktop)
Errores
- Failure / Result pattern
- Nunca lanzar excepciones a la UI
Testing
- Unit tests en domain
- Widget tests para pantallas crÃticas