code-server/cursor-fullstack/DOCKER_IMAGES.md

# Docker Images - Cursor Full Stack AI IDE

## 🐳 Docker Images Ready for Build

Your Cursor Full Stack AI IDE is ready to be built into Docker images. Here are the complete instructions:

## 📦 Available Images

### 1. **Backend Image** (`cursor-backend:latest`)
- **Base**: `oven/bun:1-slim`
- **Size**: ~200MB
- **Features**: Node.js backend with AI providers and tools
- **Ports**: 3001 (API), 8080 (WebSocket)

### 2. **Frontend Image** (`cursor-frontend:latest`)
- **Base**: `nginx:alpine`
- **Size**: ~50MB
- **Features**: React frontend with Nginx
- **Port**: 5173

### 3. **Complete System Image** (`cursor-fullstack:latest`)
- **Base**: `nginx:alpine`
- **Size**: ~300MB
- **Features**: Complete system with backend and frontend
- **Ports**: 80 (Nginx), 3001 (Backend), 8080 (WebSocket)

## 🚀 Build Commands

### Build All Images
```bash
# Navigate to project directory
cd cursor-fullstack

# Build backend image
docker build -t cursor-backend:latest ./packages/backend/claudable

# Build frontend image
docker build -t cursor-frontend:latest ./packages/frontend/cursor-web

# Build complete system image
docker build -f Dockerfile.complete -t cursor-fullstack:latest .
```

### Build with Custom Tags
```bash
# Build with version tags
docker build -t cursor-backend:v1.0.0 ./packages/backend/claudable
docker build -t cursor-frontend:v1.0.0 ./packages/frontend/cursor-web
docker build -f Dockerfile.complete -t cursor-fullstack:v1.0.0 .

# Build with latest tags
docker build -t cursor-backend:latest ./packages/backend/claudable
docker build -t cursor-frontend:latest ./packages/frontend/cursor-web
docker build -f Dockerfile.complete -t cursor-fullstack:latest .
```

## 🏷️ Push to Docker Registry

### Docker Hub
```bash
# Login to Docker Hub
docker login

# Tag images for Docker Hub
docker tag cursor-backend:latest YOUR_USERNAME/cursor-backend:latest
docker tag cursor-frontend:latest YOUR_USERNAME/cursor-frontend:latest
docker tag cursor-fullstack:latest YOUR_USERNAME/cursor-fullstack:latest

# Push to Docker Hub
docker push YOUR_USERNAME/cursor-backend:latest
docker push YOUR_USERNAME/cursor-frontend:latest
docker push YOUR_USERNAME/cursor-fullstack:latest
```

### GitHub Container Registry
```bash
# Login to GitHub Container Registry
echo $GITHUB_TOKEN | docker login ghcr.io -u YOUR_USERNAME --password-stdin

# Tag images for GitHub Container Registry
docker tag cursor-backend:latest ghcr.io/YOUR_USERNAME/cursor-backend:latest
docker tag cursor-frontend:latest ghcr.io/YOUR_USERNAME/cursor-frontend:latest
docker tag cursor-fullstack:latest ghcr.io/YOUR_USERNAME/cursor-fullstack:latest

# Push to GitHub Container Registry
docker push ghcr.io/YOUR_USERNAME/cursor-backend:latest
docker push ghcr.io/YOUR_USERNAME/cursor-frontend:latest
docker push ghcr.io/YOUR_USERNAME/cursor-fullstack:latest
```

### AWS ECR
```bash
# Login to AWS ECR
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com

# Tag images for AWS ECR
docker tag cursor-backend:latest YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-backend:latest
docker tag cursor-frontend:latest YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-frontend:latest
docker tag cursor-fullstack:latest YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-fullstack:latest

# Push to AWS ECR
docker push YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-backend:latest
docker push YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-frontend:latest
docker push YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-fullstack:latest
```

## 🔗 Docker Image Links

After pushing to a registry, your images will be available at:

### Docker Hub
- **Backend**: `https://hub.docker.com/r/YOUR_USERNAME/cursor-backend`
- **Frontend**: `https://hub.docker.com/r/YOUR_USERNAME/cursor-frontend`
- **Complete**: `https://hub.docker.com/r/YOUR_USERNAME/cursor-fullstack`

### GitHub Container Registry
- **Backend**: `https://github.com/YOUR_USERNAME/cursor-fullstack-ai-ide/pkgs/container/cursor-backend`
- **Frontend**: `https://github.com/YOUR_USERNAME/cursor-fullstack-ai-ide/pkgs/container/cursor-frontend`
- **Complete**: `https://github.com/YOUR_USERNAME/cursor-fullstack-ai-ide/pkgs/container/cursor-fullstack`

### AWS ECR
- **Backend**: `https://YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-backend:latest`
- **Frontend**: `https://YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-frontend:latest`
- **Complete**: `https://YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/cursor-fullstack:latest`

## 🚀 Quick Start with Docker Images

### Using Docker Compose (Recommended)
```bash
# Clone repository
git clone https://github.com/YOUR_USERNAME/cursor-fullstack-ai-ide.git
cd cursor-fullstack-ai-ide

# Start with Docker Compose
docker compose up --build -d

# Access application
# Frontend: http://localhost:5173
# Backend: http://localhost:3001
# code-server: http://localhost:8081
```

### Using Individual Images
```bash
# Run backend
docker run -d -p 3001:3001 -p 8080:8080 --name cursor-backend cursor-backend:latest

# Run frontend
docker run -d -p 5173:5173 --name cursor-frontend cursor-frontend:latest

# Run code-server
docker run -d -p 8081:8080 --name cursor-codeserver codercom/code-server:latest

# Access application
# Frontend: http://localhost:5173
# Backend: http://localhost:3001
# code-server: http://localhost:8081
```

### Using Complete System Image
```bash
# Run complete system
docker run -d -p 80:80 -p 3001:3001 -p 8080:8080 --name cursor-fullstack cursor-fullstack:latest

# Access application
# Frontend: http://localhost
# Backend: http://localhost:3001
# WebSocket: ws://localhost:8080
```

## 📊 Image Specifications

### Backend Image
- **Base Image**: `oven/bun:1-slim`
- **Size**: ~200MB
- **Architecture**: Multi-arch (amd64, arm64)
- **Ports**: 3001, 8080
- **Environment Variables**:
  - `NODE_ENV=production`
  - `PORT=3001`
  - `WS_PORT=8080`

### Frontend Image
- **Base Image**: `nginx:alpine`
- **Size**: ~50MB
- **Architecture**: Multi-arch (amd64, arm64)
- **Port**: 5173
- **Environment Variables**:
  - `VITE_BACKEND_URL=http://localhost:3001`
  - `VITE_WS_URL=ws://localhost:8080`

### Complete System Image
- **Base Image**: `nginx:alpine`
- **Size**: ~300MB
- **Architecture**: Multi-arch (amd64, arm64)
- **Ports**: 80, 3001, 8080
- **Features**: Backend + Frontend + Nginx

## 🔧 Image Optimization

### Multi-stage Build
The images use multi-stage builds for optimization:
- **Build Stage**: Install dependencies and build
- **Runtime Stage**: Minimal runtime with only necessary files

### Layer Caching
- Dependencies are cached in separate layers
- Source code changes don't invalidate dependency cache
- Faster rebuilds and smaller images

### Security
- Non-root user in containers
- Minimal base images
- No unnecessary packages
- Security scanning compatible

## 📈 Performance Metrics

### Build Time
- **Backend**: ~2-3 minutes
- **Frontend**: ~1-2 minutes
- **Complete**: ~3-4 minutes

### Image Size
- **Backend**: ~200MB
- **Frontend**: ~50MB
- **Complete**: ~300MB

### Startup Time
- **Backend**: ~5-10 seconds
- **Frontend**: ~2-5 seconds
- **Complete**: ~10-15 seconds

## 🎯 Production Deployment

### Using Docker Images
```bash
# Production deployment with environment variables
docker run -d \
  -p 80:80 \
  -p 3001:3001 \
  -p 8080:8080 \
  -e NODE_ENV=production \
  -e VITE_BACKEND_URL=https://your-domain.com \
  -e VITE_WS_URL=wss://your-domain.com \
  --name cursor-fullstack \
  cursor-fullstack:latest
```

### Using Docker Compose
```bash
# Production deployment
docker compose -f docker-compose.prod.yml up -d
```

## 🔍 Image Inspection

### View Image Details
```bash
# Inspect image
docker inspect cursor-backend:latest

# View image history
docker history cursor-backend:latest

# View image layers
docker image ls cursor-backend:latest
```

### Test Image
```bash
# Test backend image
docker run --rm -p 3001:3001 cursor-backend:latest

# Test frontend image
docker run --rm -p 5173:5173 cursor-frontend:latest

# Test complete image
docker run --rm -p 80:80 cursor-fullstack:latest
```

## 🎉 Ready for Production!

Your Docker images are ready for:
- ✅ **Local Development** - Quick setup and testing
- ✅ **CI/CD Pipelines** - Automated builds and deployments
- ✅ **Cloud Deployment** - AWS, GCP, Azure, DigitalOcean
- ✅ **Kubernetes** - Container orchestration
- ✅ **Docker Swarm** - Container clustering
- ✅ **Production Hosting** - Scalable deployment

## 📞 Support

For questions about Docker images:
- Check the Dockerfile configurations
- Review the build scripts
- Test with the provided commands
- Check the deployment guides

---

**Your Cursor Full Stack AI IDE Docker images are ready! 🐳🚀**