Documentation
README
Flutter UI 実装規約
アーキテクチャ概要
SSOT (Single Source of Truth) + UDF (Unidirectional Data Flow) に基づく設計。
データフローパターン
- Path A (Query): Cubit/Bloc → Widget (BlocBuilder/BlocListener)
- サーバー状態、永続化データ、共有状態
- BlocProvider を通じて単方向に流れる
- Path B (Command): Widget → Cubit method → State emit
- ユーザーアクション、API呼び出し
- Cubit のメソッド経由で状態を変更
- Path C (Local): StatefulWidget / useState
- テキスト入力、スクロール位置、展開状態等の一時的UI状態
Widget 分割ルール
禁止パターン
// NG: プライベートメソッドでのWidget分割
class MyScreen extends StatefulWidget {
Widget _buildHeader() { ... }
Widget _buildBody() { ... }
Widget _buildFooter() { ... }
}
推奨パターン
This is the opening of the README. Read the full README on GitHub.