Skip to content
JustAPI

Cloudflare Pages Deployment

This documentation site is built with Astro and Starlight, making it 100% static-site generator (SSG) compatible.

Section titled “Method 1: Git Integration (Recommended)”
  1. Push your repository to GitHub or GitLab
  2. Log into Cloudflare Dashboard → Workers & Pages → Create Application → Pages → Connect to Git
  3. Select your repository and branch
  4. Configure build settings:
    • Framework Preset: Astro
    • Root Directory: docs_site
    • Build Command: npm run build
    • Build Output Directory: dist
  5. Click Save and Deploy

Cloudflare Pages automatically builds and publishes with free global CDN, SSL, and edge distribution.

Method 2: CLI Deployment (wrangler)

Section titled “Method 2: CLI Deployment (wrangler)”
Terminal window
cd docs_site
npm run build
npx wrangler pages deploy dist --project-name=justapi-docs

Cloudflare Pages Configuration

Section titled “Cloudflare Pages Configuration”
{
  "name": "justapi-docs",
  "pages_build_output_dir": "./dist"
}

Custom Domain

Section titled “Custom Domain”
  1. Go to Cloudflare Pages → your project → Custom Domains
  2. Add your domain (e.g., docs.justapi.dev)
  3. Update DNS records

See Also

Section titled “See Also”