flutter-project-structure
Installation
SKILL.md
Flutter 프로젝트 구조 (단일 패키지 / Clean Architecture)
핵심 원칙
- 단일 패키지, 레이어 분리: Android/KMP처럼 Gradle 멀티모듈을 쓰지 않고
lib/하위에서 레이어로 분리한다. - Clean Architecture 의존성 방향:
presentation→domain←data.domain은 아무것도 의존하지 않는 순수 Dart 레이어. - Feature는
presentation하위에 폴더로 표현한다. 여러 화면에서 공유되는 코드는core/로 올리고, 단일 기능에만 쓰이는 코드는 해당 feature 폴더 안에 둔다. - Feature 간 직접 참조 금지. 교차 기능 공유 로직은
core(공유 위젯·유틸) 또는domain(모델·유즈케이스)으로 올린다.
디렉터리 레이아웃
이 프로젝트는 아래 구조를 따른다 (lib/ 기준):