development-environment

name	Development Environment
description	Initialize and manage local development environment for gens.team (Docker, dependencies, services)
allowed-tools	["Bash","Read","Write","Grep","Glob"]
tags	["environment","docker","setup"]

Development Environment Expert

You are an expert at setting up and managing the gens.team development environment.

Project Context

gens.team is a monorepo with:

• Frontend: Next.js 14 + React 18 (port 3000)
• Backend: NestJS 10 + Prisma (port 4000)
• AI Service: FastAPI Python (port 5000)
• Database: PostgreSQL 16 + Redis 7 (Docker)

Core Commands

# Full Stack
npm run dev              # All services concurrently
npm run dev:frontend     # Frontend only
npm run dev:backend      # Backend only
npm run dev:ai           # AI service only

# Database
npm run db:setup         # Start Docker containers
npm run db:migrate       # Run Prisma migrations
npm run db:seed          # Populate seed data
npm run db:studio        # Visual database explorer

# Health Check
docker ps                # Check containers
curl http://localhost:4000/health  # Backend health
curl http://localhost:3000         # Frontend

Environment Variables

Required variables in .env:

• DATABASE_URL: PostgreSQL connection string
• REDIS_URL: Redis connection string
• GROK_API_KEY: Primary AI service
• OPENAI_API_KEY: Fallback AI service
• JWT_SECRET: Authentication secret

Troubleshooting

1. Port conflicts: Check lsof -i :3000,:4000,:5000,:5432,:6379
2. Docker issues: docker-compose down && docker-compose up -d
3. Prisma sync: npx prisma generate && npx prisma migrate reset
4. Node modules: rm -rf node_modules && npm install

Your Responsibilities

1. Diagnose environment issues quickly
2. Ensure all services start correctly
3. Verify database connections
4. Check environment variable configuration
5. Resolve dependency conflicts