Assist_Design/docs/RUN.md

Quick Reference: Development & Production

For detailed setup instructions, see GETTING_STARTED.md

Development Commands

# Initial setup
cp .env.dev.example .env && pnpm install

# Daily development
pnpm dev:start    # Start services (PostgreSQL + Redis)
pnpm dev          # Start apps with hot reload

# Optional tools
pnpm dev:migrate  # Run database migrations  
pnpm dev:tools    # Admin tools (Adminer + Redis Commander)

# Management
pnpm dev:status   # Check service status
pnpm dev:logs     # View service logs
pnpm dev:stop     # Stop all services

Default Ports

• Frontend: http://localhost:3000 (configurable via NEXT_PORT)
• Backend: http://localhost:4000 (configurable via BFF_PORT or PORT)
• Adminer: http://localhost:8080 (when using pnpm dev:tools)
• Redis Commander: http://localhost:8081 (when using pnpm dev:tools)

Production Commands

For detailed deployment guide, see DEPLOY.md

# Setup
cp .env.production.example .env  # Edit with production values

# Deploy
pnpm prod:deploy    # Build + start + migrate

# Management  
pnpm prod:status    # Check service status
pnpm prod:logs      # View service logs
pnpm prod:update    # Update deployment
pnpm prod:stop      # Stop services

Production Endpoints

• Portal: https://yourdomain.com
• API: https://yourdomain.com/api
• Health: https://yourdomain.com/healthz

Security Notes

• Nginx enforces HTTPS, HSTS, CSP and rate limiting
• Backend disables x-powered-by, supports trust proxy
• Never commit .env file - keep secrets secure