deployment-build

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

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 13, 2025⬇️1downloads

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.
nameDeployment & Build
descriptionKnowledge 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