From 02dd5a20bc59ba663ee5d4469b7b0750a13511ca Mon Sep 17 00:00:00 2001
From: David Snelling <david@soulcraft.com>
Date: Fri, 20 Jun 2025 14:36:35 -0700
Subject: [PATCH] **ci(workflows): add GitHub Pages workflow for demo
 deployment with custom domain**

### Changes:
- Introduced `deploy-demo.yml` workflow in `.github/workflows/` to automate deployment to GitHub Pages:
  - Triggers on `main` branch pushes and manual workflow dispatch.
  - Includes steps for project setup, build, and deployment using `JamesIves/github-pages-deploy-action`.
- Added `examples/CNAME` with custom domain `www.soulcraft.com`.

### Purpose:
Streamlined and automated the deployment of the demo to GitHub Pages, ensuring efficient updates. Configured a custom domain for better branding and accessibility of the live demo.
---
 .github/workflows/deploy-demo.yml | 33 +++++++++++++++++++++++++++++++
 examples/CNAME                    |  1 +
 2 files changed, 34 insertions(+)
 create mode 100644 .github/workflows/deploy-demo.yml
 create mode 100644 examples/CNAME

diff --git a/.github/workflows/deploy-demo.yml b/.github/workflows/deploy-demo.yml
new file mode 100644
index 00000000..239772a8
--- /dev/null
+++ b/.github/workflows/deploy-demo.yml
@@ -0,0 +1,33 @@
+name: Deploy Demo to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout 🛎️
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js 🔧
+        uses: actions/setup-node@v3
+        with:
+          node-version: '23'
+          cache: 'npm'
+
+      - name: Install dependencies 📦
+        run: npm ci
+
+      - name: Build project 🏗️
+        run: |
+          npm run build
+          npm run build:browser
+
+      - name: Deploy to GitHub Pages 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          folder: examples
+          branch: gh-pages
diff --git a/examples/CNAME b/examples/CNAME
new file mode 100644
index 00000000..6c403167
--- /dev/null
+++ b/examples/CNAME
@@ -0,0 +1 @@
+www.soulcraft.com