Add Puppeteer end-to-end tests

.github/workflows/e2e-dev.yml

@@ -0,0 +1,78 @@
+name: E2E — Dev
+
+on:
+  push:
+    branches: [develop]
+
+concurrency:
+  group: e2e-dev-${{ github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  install:
+    name: Install dependencies
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+          cache-dependency-path: puppeteer-tests/package-lock.json
+
+      - name: Install test dependencies
+        working-directory: puppeteer-tests
+        run: npm ci
+
+      - name: Cache node_modules and Puppeteer browsers
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-puppeteer-${{ runner.os }}-${{ hashFiles('puppeteer-tests/package-lock.json') }}
+
+  e2e:
+    name: E2E dev — ${{ matrix.suite }}
+    needs: install
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    strategy:
+      fail-fast: false
+      matrix:
+        suite: [home, editor]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Restore node_modules and Puppeteer browsers
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-puppeteer-${{ runner.os }}-${{ hashFiles('puppeteer-tests/package-lock.json') }}
+
+      - name: Run ${{ matrix.suite }} tests
+        working-directory: puppeteer-tests
+        run: node --test tests/${{ matrix.suite }}.js
+        env:
+          TARGET: dev
+
+      - name: Upload debug artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-debug-dev-${{ matrix.suite }}
+          path: puppeteer-tests/screenshots/
+          retention-days: 7
+          if-no-files-found: ignore

.github/workflows/e2e-local.yml

@@ -0,0 +1,91 @@
+name: E2E — Local
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+
+concurrency:
+  group: e2e-local-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  install:
+    name: Install dependencies
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+
+      - name: Install project dependencies
+        run: npm ci
+
+      - name: Install test dependencies
+        working-directory: puppeteer-tests
+        run: npm ci
+
+      - name: Cache node_modules and Puppeteer browsers
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-${{ runner.os }}-${{ hashFiles('package-lock.json', 'puppeteer-tests/package-lock.json') }}
+
+  e2e:
+    name: E2E local — ${{ matrix.suite }}
+    needs: install
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    strategy:
+      fail-fast: false
+      matrix:
+        suite: [home, editor]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Restore node_modules and Puppeteer browsers
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            node_modules
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-${{ runner.os }}-${{ hashFiles('package-lock.json', 'puppeteer-tests/package-lock.json') }}
+
+      - name: Start dev server
+        run: npm run start -- --open false &
+        env:
+          BROWSER: none
+
+      - name: Wait for dev server
+        run: npx wait-on http://localhost:3000 --timeout 120000
+
+      - name: Run ${{ matrix.suite }} tests
+        working-directory: puppeteer-tests
+        run: node --test tests/${{ matrix.suite }}.js
+        env:
+          TARGET: local
+
+      - name: Upload debug artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-debug-${{ matrix.suite }}
+          path: puppeteer-tests/screenshots/
+          retention-days: 7
+          if-no-files-found: ignore

.github/workflows/e2e-prod.yml

@@ -0,0 +1,78 @@
+name: E2E — Prod
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: e2e-prod-${{ github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  install:
+    name: Install dependencies
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+          cache-dependency-path: puppeteer-tests/package-lock.json
+
+      - name: Install test dependencies
+        working-directory: puppeteer-tests
+        run: npm ci
+
+      - name: Cache node_modules and Puppeteer browsers
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-puppeteer-${{ runner.os }}-${{ hashFiles('puppeteer-tests/package-lock.json') }}
+
+  e2e:
+    name: E2E prod — ${{ matrix.suite }}
+    needs: install
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    strategy:
+      fail-fast: false
+      matrix:
+        suite: [home, editor]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Restore node_modules and Puppeteer browsers
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            puppeteer-tests/node_modules
+            ~/.cache/puppeteer
+          key: nm-puppeteer-${{ runner.os }}-${{ hashFiles('puppeteer-tests/package-lock.json') }}
+
+      - name: Run ${{ matrix.suite }} tests
+        working-directory: puppeteer-tests
+        run: node --test tests/${{ matrix.suite }}.js
+        env:
+          TARGET: prod
+
+      - name: Upload debug artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-debug-prod-${{ matrix.suite }}
+          path: puppeteer-tests/screenshots/
+          retention-days: 7
+          if-no-files-found: ignore

.gitignore

@@ -5,7 +5,7 @@
 firebase-debug.log
 
 # dependencies
-/node_modules
+**/node_modules
 
 # testing
 /coverage
@@ -38,7 +38,6 @@ yarn-error*
 
 # Search app
 search/service-key.json
-search/node_modules
 dev-database.json
 prod-database.json
 database.json

.husky/pre-commit

@@ -1 +1,2 @@
 npm run precommit-hook
+cd puppeteer-tests && npm run lint && npm run format -- --check

puppeteer-tests/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+screenshots/