Cloudflare Pages Deployment Guide

Flügel Information Practices is built with VitePress, compiling into a lightning-fast, zero-runtime static documentation site. It can be hosted on Cloudflare Pages (Free Tier) with global edge distribution and automated CI/CD.

---

Method 1: Automated Git-Connected Deployment (Recommended)

1. Push your repository to your Git host.
2. Log in to the Cloudflare Dashboard and navigate to Workers & Pages $\to$ Create Application $\to$ Pages $\to$ Connect to Git.
3. Select the Flugel-Information-Practices repository.
4. Set the build configurations:
   • Project Name: flugel-information-practices
   • Framework Preset: VitePress
   • Build Command: npm run docs:build
   • Build Output Directory: .vitepress/dist
   • Node.js Version: 20 (Set environment variable NODE_VERSION = 20 if necessary)
5. Click Save and Deploy. Cloudflare Pages will automatically trigger a production build on every git push to main.

---

Method 2: CI/CD Automated Workflow with Wrangler

If you prefer deploying via CI/CD pipelines using the Cloudflare Wrangler CLI, use the included workflow:

name: Deploy to Cloudflare Pages

on:
  push:
    branches: [main]
  workflow_dispatch:

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'

      - name: Install Dependencies
        run: npm ci

      - name: Build Static Site
        run: npm run docs:build

      - name: Deploy to Cloudflare Pages
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy .vitepress/dist --project-name=flugel-information-practices

---

Method 3: Direct CLI Deployment with Wrangler

# Build the production assets
npm run docs:build

# Deploy with Wrangler
npx wrangler pages deploy .vitepress/dist --project-name=flugel-information-practices