ente/.github/workflows/docs-deploy.yml

name: "Deploy (docs)"

on:
    # Run on every push to main that changes docs/
    push:
        branches: [main]
        paths:
            - "docs/**"
            - ".github/workflows/docs-deploy.yml"
    # Also allow manually running the workflow
    workflow_dispatch:

jobs:
    deploy:
        runs-on: ubuntu-latest

        defaults:
            run:
                working-directory: docs

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

            - name: Setup node and enable yarn caching
              uses: actions/setup-node@v4
              with:
                  node-version: 20
                  cache: "yarn"
                  cache-dependency-path: "docs/yarn.lock"

            - name: Install dependencies
              run: yarn install

            - name: Build production site
              # Will create docs/.vitepress/dist
              run: yarn build

            - name: Publish
              uses: cloudflare/wrangler-action@v3
              with:
                  accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
                  apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
                  # [Note: Wrangler commit-dirty]
                  #
                  # Without the --commit-dirty flag, running the wrangler-action
                  # always prints a warning when used:
                  #
                  #     Warning: Your working directory is a git repo and has uncommitted changes
                  #     To silence this warning, pass in --commit-dirty=true
                  #
                  # There is no clear documentation of if passing this is
                  # harmless, but all indications and in-practice tests seem to
                  # indicate so.
                  command: pages deploy --project-name=ente --commit-dirty=true --branch=help docs/docs/.vitepress/dist