flutter-project-structure

Installation
SKILL.md

Flutter 프로젝트 구조 (단일 패키지 / Clean Architecture)

핵심 원칙

  • 단일 패키지, 레이어 분리: Android/KMP처럼 Gradle 멀티모듈을 쓰지 않고 lib/ 하위에서 레이어로 분리한다.
  • Clean Architecture 의존성 방향: presentationdomaindata. domain은 아무것도 의존하지 않는 순수 Dart 레이어.
  • Feature는 presentation 하위에 폴더로 표현한다. 여러 화면에서 공유되는 코드는 core/로 올리고, 단일 기능에만 쓰이는 코드는 해당 feature 폴더 안에 둔다.
  • Feature 간 직접 참조 금지. 교차 기능 공유 로직은 core(공유 위젯·유틸) 또는 domain(모델·유즈케이스)으로 올린다.

디렉터리 레이아웃

이 프로젝트는 아래 구조를 따른다 (lib/ 기준):

Installs
43
GitHub Stars
23
First Seen
May 11, 2026
flutter-project-structure — junsuk5/survival-flutter-skills