Deployment

Live URLs

Backend API (GCP Cloud Run)

Repo: github.com/veda-guru-ai/veda-guru-ai-api

Deployed via Cloud Run (fully managed) with a Dockerfile:

Required environment variables:

Optional environment variables:

Database persistence

By default, the app uses SQLite (veda_guru.db) which is ephemeral — data is lost on restart. For persistent storage, set DATABASE_URL to a Neon Postgres connection string:

postgresql://user:password@ep-xxx.region.aws.neon.tech/dbname?sslmode=require

Neon free tier: 500MB storage, no credit card required. See neon.tech.

Deploying to Cloud Run

# Build and push to Artifact Registry (or use Cloud Build)
gcloud builds submit --tag gcr.io/PROJECT_ID/veda-guru-api

# Deploy to Cloud Run
gcloud run deploy veda-guru-api \
  --image gcr.io/PROJECT_ID/veda-guru-api \
  --region us-central1 \
  --memory 512Mi \
  --cpu 1 \
  --min-instances 0 \
  --max-instances 2 \
  --concurrency 80 \
  --allow-unauthenticated \
  --set-env-vars="FRONTEND_URL=https://veda-guru.com,SARVAM_API_URL=https://api.sarvam.ai/v1/chat/completions" \
  --set-secrets="SARVAM_API_KEY=sarvam-api-key:latest,TAVILY_API_KEY=tavily-api-key:latest,JWT_SECRET=jwt-secret:latest,DATABASE_URL=database-url:latest"

Frontend UI (Cloudflare Pages)

Repo: github.com/veda-guru-ai/veda-guru-ai-ui

Domain: veda-guru.com (bought from Namecheap, DNS managed by Cloudflare)

Deploy setup

1. Connect repo to Cloudflare Pages
2. Build settings:
   • Build command: (none — static files)
   • Build output directory: / (or the repo root)
3. Add custom domains in Cloudflare Pages dashboard → project → Custom domains:
   • veda-guru.com (main site)
   • admin.veda-guru.com (admin panel subdomain)

Routing

_redirects — friendly URL rewrites (status 200 means internal rewrite, not a redirect):

/chat      /samvada.html     200
/learn     /learning.html    200
/article   /wisdom.html      200
/maharshi  /rishivani.html   200
/admin     /admin-panel.html 200

functions/_middleware.js — a Cloudflare Pages Function that routes admin.veda-guru.com → admin-panel.html. Static assets (CSS, JS, images) pass through normally.

Pages

| URL | File | |—–|——| | / | index.html — landing page | | /chat | samvada.html — main Q&A (Samvāda) | | /learn | learning.html — Gurukula learning paths | | /article | wisdom.html — daily wisdom articles | | /maharshi | rishivani.html — Maharshi voice chat | | /admin | admin-panel.html — admin dashboard | | admin.veda-guru.com | → admin-panel.html (via Pages Function) |

Update API_URL in script.js, maharshi.js, and all HTML files if the backend URL changes.

Documentation (Cloudflare Pages)

Repo: github.com/veda-guru-ai/veda-guru-ai-docs

1. Connect repo to Cloudflare Pages
2. Build settings:
   • Build command: bundle exec jekyll build
   • Build output directory: _site
3. Set custom domain: docs.veda-guru.com
4. Pushes to main auto-deploy the docs site

Redeploying after changes

All three services auto-deploy when you push to the main branch of their respective repos. No manual steps needed.

Cold start

Cloud Run scales to zero after ~5 minutes of inactivity. The first request after idle triggers a cold start (10-30s). The frontend handles this with a connection status card and retry loop.