deploy-docs.yml

name: Deploy Docs to Cloudflare

on:
  push:
    branches: ["main"]
    paths:
      - "src/**"
      - "pyproject.toml"
  workflow_dispatch: # Allows manual trigger button

jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      deployments: write

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.13"
          cache: "pip"

      - name: Install Dependencies
        # Installs your project dependencies from the root pyproject.toml
        run: |
          python -m pip install --upgrade pip
          pip install ".[dev]"

      - name: Build MkDocs
        # 1. Build the site using the config in the subfolder
        # 2. Output to a temporary 'site' folder
        run: mkdocs build -f src/mkdocs.yml -d site

      - name: Prepare Subdirectory Structure
        run: |
          mkdir -p dist/
          mv src/site/* dist/

      - name: Deploy to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: codestory-docs
          directory: dist
          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
          branch: main