# Deployment & Build

> Knowledge of the Vercel deployment pipeline, hybrid build scripts, and environment configuration.

- Skill: `majiayu000/deployment-build` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/deployment-build`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/deployment-build/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/deployment-build

---


# 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`