deployment-build
Knowledge of the Vercel deployment pipeline, hybrid build scripts, and environment configuration.
When & Why to Use This Skill
This Claude skill provides comprehensive expertise in managing Vercel deployment pipelines, optimizing hybrid build scripts for Next.js and Docusaurus integrations, and configuring complex environment variables for seamless cloud deployments. It ensures a robust and automated workflow for full-stack applications, particularly those involving AI integrations and static site generation.
Use Cases
- Automating hybrid builds: Streamlining the process of building and merging Docusaurus documentation into a Next.js public directory during the Vercel deployment phase.
- Full-stack Vercel configuration: Expertly configuring vercel.json to handle Python runtimes for FastAPI backends and managing complex API routing/rewrites.
- Environment security and setup: Ensuring critical environment variables like GEMINI_API_KEY and QDRANT_URL are correctly implemented for production-ready AI applications.
- Deployment troubleshooting: Debugging build script failures and environment mismatches within the Vercel ecosystem to maintain high uptime.
| 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:
cd textbook && npm install && npm run build(Builds Docs)npx shx mkdir -p public/docs(Creates output dir)npx shx cp -r textbook/build/* public/docs/(Copies static docs to Next.js public folder)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_KEYQDRANT_URLQDRANT_API_KEYBETTER_AUTH_SECRETNEXT_PUBLIC_APP_URL