kindie

설치 및 설정

kindie 프로젝트를 로컬 환경에서 실행하는 방법을 안내합니다.

사전 요구사항

  • Node.js 20 이상
  • PostgreSQL 데이터베이스 (Supabase 권장)
  • npm

1. 프로젝트 클론 및 의존성 설치

git clone <your-repo-url> my-app
cd my-app
npm install

2. 환경변수 설정

setup 스크립트를 실행하면 .env.local 파일이 자동 생성됩니다:

npm run setup

npm run setup는 기본값을 채워주며, DATABASE_URL은 Supabase 연결 문자열로 교체하는 것을 권장합니다.

생성된 .env.local 파일을 열어 필요한 값을 채워넣으세요. 각 환경변수에 대한 자세한 설명은 환경변수 문서를 참고하세요.

3. 데이터베이스 설정

Supabase 사용 (권장)

  1. Supabase에서 새 프로젝트 생성
  2. Settings > Database > Connection string > Transaction pooler 복사
  3. .env.local의 DATABASE_URL에 붙여넣기
# .env.local
DATABASE_URL="postgresql://postgres.[PROJECT-REF]:[DB-PASSWORD]@[REGION].pooler.supabase.com:6543/postgres"

스키마 푸시 및 시드 데이터

# 데이터베이스 스키마 적용
npm run db:push

# 시드 데이터 삽입 (구독/결제 샘플 플랜 사용 시)
npm run db:seed

4. 개발 서버 실행

npm run dev

http://localhost:3000으로 접속하여 동작을 확인하세요.

다음 단계