Deployment config: Fly.io (backend) + Vercel (frontend) (Issue #54)

README.md

@@ -107,6 +107,36 @@ poetry run black .           # fix formatting
 
 GitHub Actions runs tests and Black checks on push/PRs. Coverage is optionally uploaded to Codecov.
 
+## Deployment
+
+The React frontend is hosted on Vercel and the FastAPI backend on Fly.io.
+
+### Frontend (Vercel)
+
+Vercel deploys automatically on push to `main` via GitHub integration.
+
+1. Install the Vercel CLI: `npm install -g vercel`
+2. Link the project: `cd frontend && vercel link`
+3. Set the Mapbox token as an environment variable in the Vercel dashboard:
+   - Key: `VITE_MAPBOX_TOKEN`
+   - Value: your Mapbox token
+   - Environment: Production (and Preview if desired)
+4. Deploy manually if needed: `vercel --prod`
+
+### Backend (Fly.io)
+
+1. Install the Fly CLI: `brew install flyctl`
+2. Authenticate: `flyctl auth login`
+3. Create the app (first time only): `cd backend && flyctl launch --no-deploy`
+4. Set secrets:
+   ```sh
+   flyctl secrets set GOOGLE_MAPS_API_KEY=your_key_here
+   ```
+5. Deploy: `flyctl deploy`
+6. Check health: `curl https://indy-explorer-backend.fly.dev/health`
+
+Subsequent deploys run automatically on push to `main` via the CI/CD pipeline (to be configured in a later issue).
+
 ## Contributing
 
 1. Fork the repository.

backend/.env.example

@@ -0,0 +1,5 @@
+# Backend environment variables
+# Copy to .env and fill in values (never commit .env)
+
+# Required for geocoding (only needed when regenerating data/resort_locations.csv)
+GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here

backend/fly.toml

@@ -0,0 +1,23 @@
+app = "indy-explorer-backend"
+primary_region = "iad"
+
+[build]
+
+[http_service]
+  internal_port = 8000
+  force_https = true
+  auto_stop_machines = "stop"
+  auto_start_machines = true
+  min_machines_running = 0
+
+[[http_service.checks]]
+  grace_period = "10s"
+  interval = "30s"
+  method = "GET"
+  path = "/health"
+  timeout = "5s"
+
+[[vm]]
+  memory = "256mb"
+  cpu_kind = "shared"
+  cpus = 1

frontend/.env.example

@@ -0,0 +1,6 @@
+# Frontend environment variables
+# Copy to .env.local and fill in values (never commit .env.local)
+# In Vercel, set these in the dashboard under Project Settings > Environment Variables
+
+# Required for map rendering
+VITE_MAPBOX_TOKEN=your_mapbox_token_here

frontend/vercel.json

@@ -0,0 +1,7 @@
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "rewrites": [
+    { "source": "/(.*)", "destination": "/index.html" }
+  ]
+}