Development Environment

Development Environment

# Development Environment

이 문서는 ImGoing 개발환경과 로컬 셋업을 위한 최소 절차를 정리한다. 새로운 개발자가 합류할 때 이 문서를 먼저 최신화한다.

범위

모바일 앱: React Native + Expo
웹: Next.js (사용자 웹, 가맹점 웹)
백엔드: Supabase (Postgres, RPC, Auth)

공통 준비

Git 설치
Node.js LTS 설치
패키지 매니저 하나를 고정한다 (pnpm)
환경변수 파일을 준비한다 (.env.local 또는 프로젝트 규칙에 따름)

환경변수

각 앱 폴더에 .env.local 파일을 두고 필요한 키를 기입한다.
필요한 키 목록은 코드와 문서에 함께 유지한다.
예시 키(필요 시 추가/삭제):
- SUPABASE_URL
- SUPABASE_ANON_KEY
- STRIPE_PUBLIC_KEY (웹에서만 필요)

로컬 실행

패키지 매니저와 스크립트 이름은 각 앱의 package.json을 기준으로 한다.

모바일 앱 (Expo)
- 예: install
- 예: npx expo start (또는 run start)
- 에뮬레이터 사용 시 Android Studio 설치
웹 (Next.js)
- 예: install
- 예: run dev

백엔드 (Supabase)

기본은 원격 Supabase 프로젝트를 사용한다.
로컬 DB가 필요하면 Supabase CLI 기반 로컬 실행 절차를 추가한다.

체크리스트

.env.local에 필요한 키가 모두 들어있다.
모바일 앱이 로컬에서 정상 실행된다.
웹 앱이 로컬에서 정상 실행된다.
기본 API 호출이 성공한다.

Buy me a coffee