feat(gh-pages): add github pages workflow

.github/workflows/deploy-github-pages.yml

@@ -0,0 +1,42 @@
+name: Deploy GitHub Pages
+
+on:
+  workflow_dispatch:
+    inputs:
+      clean_deploy:
+        description: 'Clean deployment (removes all existing files)'
+        type: boolean
+        default: false
+        required: false
+  push:
+    paths:
+      - 'gh-pages/**'
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Deploy to GitHub Pages
+        uses: JamesIves/[email protected]
+        with:
+          token: ${{ secrets.DEPLOY_TOKEN }}
+          branch: gh-pages
+          folder: gh-pages
+          clean: ${{ inputs.clean_deploy }}
+          clean-exclude: |
+            stg/**
+            visualization/**