- Docker Desktop 설치
- Google OAuth 클라이언트 ID (Google Cloud Console에서 발급)
- SMTP 계정 (AWS SES, Gmail, 기타 메일 서버)
루트 디렉토리에 .env 파일을 생성합니다.
JWT_SECRET=your_jwt_secret_here
GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com
POSTGRES_PASSWORD=your_db_password
APP_URL=http://localhost
SMTP_HOST=email-smtp.ap-northeast-2.amazonaws.com
SMTP_PORT=587
SMTP_USER=your_smtp_username
SMTP_PASS=your_smtp_password
SMTP_FROM=noreply@yourdomain.comdocker compose up -d --build브라우저에서 http://localhost로 접속합니다.
docker compose downdocker compose down -vDocker 없이 직접 실행하려면 다음이 필요합니다.
- Node.js 20+
- pnpm (
npm install -g pnpm) - PostgreSQL 17
pnpm install# 백엔드 (apps/api)
pnpm --filter api dev
# 프론트엔드 (apps/web) — 별도 터미널
pnpm --filter web dev프론트엔드는 http://localhost:5173, 백엔드는 http://localhost:3001로 실행됩니다.
로컬 개발 시 Vite의
vite.config.js에서/api프록시를http://localhost:3001으로 설정해야 합니다.