fix: optimize Docker build to reduce storage usage on HuggingFace

- Use multi-stage build with alpine images where possible
- Implement aggressive cleanup after each build stage
- Use Next.js standalone output mode
- Exclude unnecessary files via comprehensive .dockerignore
- Copy only runtime files (no tests, docs, or dev files)
- Clean all package manager caches
- Fixes 'storage limit exceeded (50G)' error

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

.dockerignore

@@ -1,14 +1,94 @@
-node_modules
-.next
+# Version control
 .git
 .gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+.venv
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+*.egg-info/
+dist/
+build/
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Next.js
+.next/
+out/
+frontend/.next/
+frontend/out/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Environment files
+.env
+.env.*
+*.local
+
+# Documentation
 README.md
-docker-compose.yml
-Dockerfile.dev.*
+*.md
+docs/
+
+# Docker
+Dockerfile*
+docker-compose*
+
+# Tests
+tests/
+backend/tests/
+*.test.*
+*.spec.*
+
+# Logs
 *.log
-.DS_Store
-__pycache__
-*.pyc
-.pytest_cache
-.env.local
-.env.*.local
+logs/
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+temp/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Large files
+*.pdf
+*.zip
+*.tar.gz
+*.rar
+
+# Development files
+Makefile
+pyproject.toml
+.pre-commit-config.yaml
+alembic.ini
+migrations/
+
+# Cache
+.cache/
+.npm/
+.yarn/

Dockerfile

@@ -1,56 +1,87 @@
 # Multi-stage Docker build for Next.js + FastAPI on Hugging Face Spaces
 
 # Stage 1: Build Next.js frontend
-FROM node:18-slim AS frontend-builder
+FROM node:18-alpine AS frontend-builder
 
 WORKDIR /frontend
 
-# Copy package files
-COPY frontend/package*.json ./
+# Copy only package files first (better caching)
+COPY frontend/package.json frontend/package-lock.json* ./
 
-# Install dependencies (use install if no lock file exists)
-RUN npm install --production=false
+# Install dependencies with clean install and cache clean
+RUN npm ci --only=production && \
+    npm cache clean --force
 
 # Copy frontend source
 COPY frontend/ ./
 
-# Build Next.js app
-RUN npm run build
-
-# Stage 2: Final runtime image
+# Build Next.js app with standalone output
+RUN npm run build && \
+    # Remove source files after build
+    rm -rf src/ components/ pages/ styles/ && \
+    # Clean npm cache
+    npm cache clean --force
+
+# Stage 2: Python dependencies
+FROM python:3.9-slim AS python-deps
+
+# Install build dependencies
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements and install Python packages
+COPY requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt && \
+    # Clean pip cache
+    rm -rf ~/.cache/pip
+
+# Stage 3: Final runtime image (minimal)
 FROM python:3.9-slim
 
 # Create non-root user (required by Hugging Face)
-RUN useradd -m -u 1000 user
+RUN useradd -m -u 1000 user && \
+    # Install only runtime dependencies
+    apt-get update && \
+    apt-get install -y --no-install-recommends \
+    nodejs \
+    npm \
+    && rm -rf /var/lib/apt/lists/* && \
+    apt-get clean
+
+# Switch to user
 USER user
-ENV PATH="/home/user/.local/bin:$PATH"
-
 WORKDIR /app
 
-# Install Python dependencies
-COPY --chown=user requirements.txt .
-RUN pip install --no-cache-dir --upgrade -r requirements.txt
+# Copy Python packages from deps stage
+COPY --from=python-deps --chown=user /root/.local /home/user/.local
+ENV PATH="/home/user/.local/bin:$PATH"
 
-# Copy FastAPI backend
-COPY --chown=user backend/ ./backend/
+# Copy only necessary backend files (no tests, no migrations)
+COPY --chown=user backend/api ./backend/api
+COPY --chown=user backend/models ./backend/models
+COPY --chown=user backend/services ./backend/services
+COPY --chown=user backend/*.py ./backend/
 
-# Copy built Next.js frontend from builder stage
-COPY --from=frontend-builder --chown=user /frontend/.next ./frontend/.next
-COPY --from=frontend-builder --chown=user /frontend/package*.json ./frontend/
-COPY --from=frontend-builder --chown=user /frontend/node_modules ./frontend/node_modules
+# Copy minimal Next.js build from builder
+COPY --from=frontend-builder --chown=user /frontend/.next/standalone ./frontend/
+COPY --from=frontend-builder --chown=user /frontend/.next/static ./frontend/.next/static
 COPY --from=frontend-builder --chown=user /frontend/public ./frontend/public
-
-# Install Node.js in final image for Next.js runtime
-USER root
-RUN apt-get update && apt-get install -y nodejs npm && rm -rf /var/lib/apt/lists/*
-USER user
+COPY --from=frontend-builder --chown=user /frontend/package.json ./frontend/
 
 # Copy startup script
 COPY --chown=user start.sh .
 RUN chmod +x start.sh
 
+# Set environment to reduce memory usage
+ENV NODE_ENV=production
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+
 # Expose port 7860 (required by Hugging Face Spaces)
 EXPOSE 7860
 
 # Start both services
-CMD ["./start.sh"]
+CMD ["./start.sh"]