port

CLAUDE.md

@@ -49,7 +49,10 @@ cd frontend/frontend  # Note the nested directory
 npm install
 
 # Run frontend dev server (with proxy to backend)
-npm run dev  # Runs on port 3000
+npm run dev  # Runs on port 3000 by default
+
+# Run on custom port
+PORT=4000 npm run dev
 
 # Build for production (outputs to backend/static/)
 npm run build
@@ -87,11 +90,14 @@ docker compose up --build
 # Run database migrations inside container
 docker compose exec backend uv run flask db migrate -m "Description"
 docker compose exec backend uv run flask db upgrade
+
+# Use custom frontend port (defaults to 3000)
+FRONTEND_PORT=4000 docker compose up
 ```
 
 **Services:**
 - Backend: http://localhost:5001 (Flask + SocketIO)
-- Frontend: http://localhost:3000 (Vite dev server)
+- Frontend: http://localhost:3000 (Vite dev server, configurable via `FRONTEND_PORT` env var)
 
 **Hot Reload:**
 - Backend: Changes to `backend/`, `main.py`, and `migrations/` automatically reload Flask