flutter-architecture

为使用Riverpod与Supabase的Flutter应用定义项目结构与架构规范。当你需要创建新功能或整理代码时，可选用此方法。

SKILL.md

--- frontmatter

name: flutter-architecture
description: Defines project structure and architectural conventions for a Flutter app using Riverpod and Supabase. Use when creating new features or organizing code.

Flutter Architecture Skill

This skill defines how code should be structured in the hoya_app Flutter project.

When to use this skill

•Creating a new feature or screen
•Adding a new domain model
•Unsure where a file should live
•Refactoring for clarity

Project structure

Use a feature-first layout:

code

lib/
  features/
    auth/
      data/
      domain/
      presentation/
    home/
    settings/
  core/
    router/
    theme/
    widgets/
    utils/

Layer responsibilities

•
presentation/
- •Widgets, screens, UI logic
- •Reads state from providers
•
domain/
- •Plain Dart models and business rules
- •No Flutter imports
•
data/
- •Supabase queries
- •DTOs and mappers

Rules

•UI must not talk to Supabase directly
•Providers live close to the feature they serve
•Shared widgets go in core/widgets