deploy-docs.yml

name: Deploy docs

# Builds the docs site and deploys to Azure Static Web Apps on every push
# to the `release` branch.
#
# Required repo secrets:
#   SWA_TOKEN          Azure Static Web Apps deployment token
#   UMAMI_WEBSITE_ID   Analytics site ID baked into the docs build
#
# Required repo variable:
#   SWA_ENV            SWA environment name (leave unset for production)

on:
  push:
    branches: ["release"]
  workflow_dispatch:

permissions:
  contents: read

jobs:
  deploy-docs:
    name: Build and deploy docs
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          submodules: true

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22

      - name: Enable Corepack
        run: npm i -g corepack@latest

      - name: Install pnpm
        run: corepack prepare

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      # SDK must build first so TypeDoc can read its compiled types.
      - name: Build SDK
        run: pnpm --filter @workflowbuilder/sdk build:lib

      - name: Build docs
        run: pnpm --filter @workflow-builder/docs build
        env:
          UMAMI_WEBSITE_ID: ${{ secrets.UMAMI_WEBSITE_ID }}

      - name: Deploy to Azure Static Web Apps
        uses: Azure/static-web-apps-deploy@v1
        with:
          azure_static_web_apps_api_token: ${{ secrets.SWA_TOKEN }}
          action: "upload"
          app_location: "apps/docs/dist"
          skip_app_build: true
          skip_api_build: true
          deployment_environment: ${{ vars.SWA_ENV }}