folder map

프로젝트 구조는 실행 위치와 책임으로 읽는다

폴더 이름을 외우기보다 라우팅, 공용 컴포넌트, 서버 유틸, 정적 자산의 책임을 분리해 봅니다.

app

app 라우팅

URL, layout, page, loading, error 같은 화면 단위 흐름을 담습니다.

components

컴포넌트 묶음

여러 화면에서 재사용되는 UI를 두고 client 여부를 명확히 표시합니다.

lib

서버 유틸

데이터 접근, 인증 헬퍼, 외부 API 호출처럼 화면 밖 로직을 모읍니다.

public

정적 자산

이미지, 아이콘, 공개 파일처럼 URL로 직접 제공할 자산을 둡니다.

추가할 때 새 파일이 URL을 만들면 app, 여러 곳에서 쓰이면 components나 lib로 보냅니다.
옮길 때 import 경로와 서버/클라이언트 경계를 함께 확인해 런타임 오류를 막습니다.
정리할 때 폴더가 커지면 기능 단위 하위 폴더를 만들고 공개 API를 좁힙니다.