ci(docs): add Azure SWA deploy workflow (WB-212) (#16)

Author: piotrblaszczyk

.github/workflows/deploy-docs.yml

@@ -0,0 +1,62 @@
+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 }}