# Flutter BLoC 架构助手

`Flutter` `BLoC` `Clean Architecture` `Dart` `状态管理`

# Flutter BLoC + 整洁架构

一套帮助 AI 编程助手构建 Flutter 应用的指令集，涵盖 BLoC 状态管理、清晰分层架构与一致设计主题。

![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)

## 内容概览

- `SKILL.md`：架构规范与模式说明
- `examples/`：可运行的代码示例

## 工作原理

```
UI → BLoC → Repository → Datasource → Backend
```

不在 Widget 中写业务逻辑。不硬编码颜色。不使用魔法数字。

## 快速开始

通过 Skills CLI 安装：

```bash
npx skills add https://github.com/abdelhakrazi/flutter-bloc-clean-architecture-skill --skill flutter-bloc-development
```

或者直接克隆此仓库，手动添加到你的 AI 编程助手中。

## 示例

- [earnings/](./examples/earnings/)：完整功能示例，采用功能优先结构（官方 BLoC 模式）
- [shared/data/](./examples/shared/data/)：跨功能共享的数据源与数据模型
- [shared/widgets/](./examples/shared/widgets/)：可复用的符合设计系统规范的组件

## 许可证

Apache 2.0