test(client): add Percy visual regression testing

.github/workflows/visual_regression.yml

@@ -0,0 +1,39 @@
+name: Visual Regression
+
+on:
+  pull_request:
+  push:
+    branches:
+      - staging
+      - master
+
+jobs:
+  visual_regression:
+    name: visual_regression
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./client
+    env:
+      PERCY_TOKEN: ${{ secrets.PERCY_TOKEN }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: client/package-lock.json
+      - name: Install dependencies
+        run: npm ci
+      - name: Install Chromium
+        run: npx playwright install --with-deps chromium
+      - name: Run visual regression test
+        run: |
+          if [ -n "$PERCY_TOKEN" ]; then
+            npm run test:visual
+          else
+            echo "PERCY_TOKEN is not configured; running the browser test without uploading snapshots."
+            npm run test:visual:local
+          fi

.gitignore

@@ -20,6 +20,8 @@ node_modules/
 # Build / Dist
 dist
 build
+playwright-report/
+test-results/
 
 # macOS Metafiles
 .DS_Store