docs/deploy-hf-docker.md

Deploy to Hugging Face Spaces (Docker)

This project uses Laravel as runtime and serves the built React app from public/fe.

What changed

• Dockerfile is now multi-stage:
  • Build frontend with Vite
  • Install PHP dependencies with Composer
  • Run Laravel on port 7860
• Startup script auto-creates .env from .env.example and generates APP_KEY if missing.

Required runtime variables (Space Settings -> Variables/Secrets)

• API_URL (target backend API base URL for BFF proxy, example: https://your-backend/api/v1)
• Optional:
  • APP_ENV=production
  • APP_DEBUG=false

Optional build variables

You can override these during Docker build:

• VITE_API_URL
• VITE_DUMMY_AUTH_MODE
• VITE_APP_BASENAME

If not set, Dockerfile defaults are used.

Health check

After deploy, test:

• / (Laravel welcome page)
• /fe/login (React app)
• /api/bff/health (BFF health)