add deploy workflow

Author: slax57

.github/workflows/deploy-doc-headless.yml

@@ -0,0 +1,51 @@
+name: 📕 Deploy headless docs
+on:
+    push:
+        branches:
+            - main
+    pull_request: # TODO remove
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+    cancel-in-progress: true
+
+permissions:
+    pages: write
+    contents: write
+
+jobs:
+    deploy:
+        name: 📕 Deploy headless docs
+        runs-on: ubuntu-latest
+
+        env:
+            PRODUCTION_REMOTE: https://git:${{ secrets.DEPLOY_TOKEN || secrets.GITHUB_TOKEN }}@github.com/${{ vars.DEPLOY_REPOSITORY || github.repository }}
+
+        steps:
+            - name: 📥 Checkout repo
+              uses: actions/checkout@v4
+
+            - name: ⚙️ Setup node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: yarn
+
+            - name: ⚙️ Setup git
+              run: |
+                  echo Deploying to pages to $PRODUCTION_REMOTE
+                  git remote set-url origin https://git:${{ secrets.GITHUB_TOKEN }}@github.com/${GITHUB_REPOSITORY}
+                  git remote add production $PRODUCTION_REMOTE
+                  git config --global user.email [email protected]
+                  git config --global user.name github-actions-bot
+
+            - name: 📥 Download deps
+              run: yarn install --frozen-lockfile
+
+            - name: 🔨 Build
+              run: cd docs_headless && yarn build
+
+            - name: 📡 Deploy GitHub pages
+              run: npx gh-pages --remote production -d dist -b ${{ vars.DEPLOY_BRANCH || 'gh-pages' }}
+              env:
+                  GITHUB_TOKEN: ${{ secrets.DEPLOY_TOKEN || secrets.GITHUB_TOKEN }}