kooltab-backoffice/docs/local-development.md

Local Development

Prerequisites

• Node.js >= 18
• pnpm >= 8

Setup

# Clone the repository
git clone <repo>
cd kooltap_backoffice

# Install dependencies
pnpm install

# Copy environment variables
cp .env.example apps/api/.env

# Generate Prisma client
cd apps/api
pnpm db:generate

# Run migrations
pnpm db:migrate

# Seed demo data
pnpm db:seed
cd ../..

Running

# Start both API and Dashboard
pnpm dev

Or individually:

cd apps/api && pnpm dev
cd apps/dashboard && pnpm dev

Database Commands

pnpm db:generate   # Generate Prisma client
pnpm db:migrate    # Run migrations
pnpm db:seed       # Seed demo data
pnpm db:reset      # Reset database and re-seed

Environment Variables

API (apps/api/.env)

• DATABASE_URL - PostgreSQL connection URL (docker compose up postgres starts one)
• JWT_SECRET - JWT signing secret
• PORT - API port (default: 3001)
• CORS_ORIGIN - Allowed CORS origin (default: http://localhost:3000)

Dashboard

• NEXT_PUBLIC_API_URL - API base URL (default: http://localhost:3001/api/v1)