gittydocsgittydocs

Vercel ▲

Deploy your docs to Vercel.

Local Source

If GITTYDOCS_SOURCE points at a folder in this repo, build then deploy ./dist/client.

via Vercel (recommended)

Connect the repo in Vercel, then set:

  • Build Command: npx gittydocs@latest build "./docs"
  • Output Directory: dist/client

If your docs folder isn't docs/, update the build path.

via GitHub Actions

Generate a workflow:

npx gittydocs@latest deploy --vercel

This writes .github/workflows/deploy-gittydocs.yml.

Required GitHub Actions secret:

  • VERCEL_TOKEN

Generated workflow:

name: Deploy Gittydocs (Vercel)
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - uses: oven-sh/setup-bun@v2
      - run: npx gittydocs@latest build "./docs"
      - run: npx vercel@latest deploy --prod --yes --token="${VERCEL_TOKEN}" "./dist/client"
        env:
          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}