---

name: deployment-build description: Knowledge of the Vercel deployment pipeline, hybrid build scripts, and environment configuration.

Deployment & Build Pipeline

Hybrid Build Process

Our project combines a Next.js root app with a Docusaurus documentation app.

• Build Command: npm run build
• Logic:
  1. cd textbook && npm install && npm run build (Builds Docs)
  2. npx shx mkdir -p public/docs (Creates output dir)
  3. npx shx cp -r textbook/build/* public/docs/ (Copies static docs to Next.js public folder)
  4. next build (Builds the main Next.js app)

Vercel Configuration

• File: backend/vercel.json
• Python Runtime: Used for the FastAPI backend (backend/main.py).
• Routes: Rewrites all /api/* requests to the Python function.

Environment Variables

Ensure these are set in the Vercel Dashboard:

• GEMINI_API_KEY
• QDRANT_URL
• QDRANT_API_KEY
• BETTER_AUTH_SECRET
• NEXT_PUBLIC_APP_URL