1. 설계 목표

1.1 디렉토리별 역할을 명확하게 분리

단일 레포 안에서 Web·Native·공통 코드가 섞이지 않도록, 책임 기반 디렉토리 구조를 적용한다.

공통 규칙

• apis: API 호출 함수 모음
• assets: 이미지, 아이콘, 폰트 등 정적 리소스
• components: UI 컴포넌트
• constants: 상수 정의
• hooks: 비즈니스 로직 / 재사용 로직
• stores: 전역 상태 관리 (Zustand, Recoil, Jotai 등)
• styles: 글로벌 스타일, 테마 정의
• types: TS 타입
• utils: 유틸 함수

이 규칙은 Web/RN 모두 동일하게 적용되며, packages/에서 공유 가능하도록 구성함.

핵심

• app(Next.js)와 native(RN)는 껍데기(Shell) 역할만 한다.
  • Next.js → 라우트 정의만 담당
  • RN → Navigation Screen + WebView Shell만 담당
• 도메인 패키지(packages/{domain})가 진짜 코드가 존재하는 곳
  • UI, 로직, API, hooks, utils, types 모두 포함
• Web과 RN은 동일한 도메인 로직을 공유하며, UI는 플랫폼별로 분기