skills/flutter-bloc-development/README.md

42 lines
1.3 KiB
Markdown

# Flutter BLoC + Clean Architecture
A set of instructions to help your AI coding assistant build Flutter apps with proper architecture with BLoC state management, clean layers, and consistent design themes.
![Flutter](https://img.shields.io/badge/Flutter-02569B?style=flat&logo=flutter&logoColor=white)
![Dart](https://img.shields.io/badge/Dart-0175C2?style=flat&logo=dart&logoColor=white)
![BLoC](https://img.shields.io/badge/BLoC-Pattern-blue)
![License](https://img.shields.io/badge/License-Apache%202.0-blue)
## What's Inside
- `SKILL.md`: The architecture rules and patterns
- `examples/`: Working code samples
## How It Works
```
UI → BLoC → Repository → Datasource → Backend
```
No business logic in widgets. No hardcoded colors. No magic numbers.
## Get Started
Install with the Skills CLI:
```bash
npx skills add https://github.com/abdelhakrazi/flutter-bloc-clean-architecture-skill --skill flutter-bloc-development
```
Or grab this repo and add it to your AI coding assistant manually.
## Examples
- [earnings/](./examples/earnings/): Full feature with feature-first structure (official BLoC pattern)
- [shared/data/](./examples/shared/data/): Shared datasources and models used across features
- [shared/widgets/](./examples/shared/widgets/): Reusable design-system-compliant widgets
## License
Apache 2.0