shoom3301 · Aug 27, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/.env.local.example b/.env.local.example
@@ -15,8 +15,3 @@ REACT_APP_TG_DEV_BYPASS=true
 # End To End Test
 #######################################
 # ⚠️ Required for E2E tests to run
-
-# Cypress Integration Tests
-CYPRESS_INTEGRATION_TEST_PRIVATE_KEY=
-CYPRESS_INTEGRATION_TESTS_ALCHEMY_KEY=
-CYPRESS_INTEGRATION_TESTS_INFURA_KEY=
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -187,69 +187,9 @@ jobs:
       - name: Run typecheck
         run: pnpm run typecheck
 
-  integration-tests:
-    name: Cypress
-    if: ${{ false }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      - name: Increase watchers
-        run: echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
-
-      - name: Set up node
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm run install:ci
-
-      - name: Install Cypress binary
-        working-directory: apps/cowswap-frontend-e2e
-        run: npx cypress install
-
-      - name: Start server in the background
-        run: pnpm run preview &
-
-      # Actually run tests, building repo
-      - name: Cypress run
-        id: cypress-run
-        uses: cypress-io/github-action@b7a7441d775af8f8b9d19945c10dd689a51dba68 # v7.2.0
-        with:
-          wait-on: http://[::1]:3000
-          wait-on-timeout: 600
-          install: false
-          working-directory: apps/cowswap-frontend-e2e
-        env:
-          CYPRESS_INTEGRATION_TEST_PRIVATE_KEY: ${{ secrets.CYPRESS_INTEGRATION_TEST_PRIVATE_KEY }}
-          CYPRESS_INTEGRATION_TESTS_ALCHEMY_KEY: ${{ secrets.CYPRESS_INTEGRATION_TESTS_ALCHEMY_KEY }}
-          CYPRESS_INTEGRATION_TESTS_INFURA_KEY: ${{ secrets.CYPRESS_INTEGRATION_TESTS_INFURA_KEY }}
-
-      # - uses: actions/upload-artifact@v3
-      #   if: always()
-      #   with:
-      #     name: cypress-videos
-      #     path: |
-      #       cypress-custom/videos
-      #       cypress-custom/screenshots
-
-      # Open tmate ssh connection on failure for debugging
-      # Uncomment when needed and push upstream
-#      - name: Setup tmate session
-#        uses: mxschmitt/action-tmate@v3
-#        if: ${{ failure() }}
-
   notify-failure:
     name: Notify Slack on Failure
-    needs: [setup, test, lint, typecheck, agent-harness, integration-tests]
+    needs: [setup, test, lint, typecheck, agent-harness]
     runs-on: ubuntu-latest
     if: always() && failure() && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/develop')
 
@@ -261,7 +201,6 @@ jobs:
           [ "$LINT_RESULT" = "failure" ] && failed_jobs+=("Lint")
           [ "$TYPECHECK_RESULT" = "failure" ] && failed_jobs+=("Typecheck")
           [ "$AGENT_HARNESS_RESULT" = "failure" ] && failed_jobs+=("Agent Harness")
-          [ "$INTEGRATION_TESTS_RESULT" = "failure" ] && failed_jobs+=("Cypress")
 
           if [ ${#failed_jobs[@]} -eq 0 ]; then
             failure_summary="CI"
@@ -280,4 +219,3 @@ jobs:
           LINT_RESULT: ${{ needs.lint.result }}
           TYPECHECK_RESULT: ${{ needs.typecheck.result }}
           AGENT_HARNESS_RESULT: ${{ needs.agent-harness.result }}
-          INTEGRATION_TESTS_RESULT: ${{ needs.integration-tests.result }}
diff --git a/.github/workflows/e2e-pw-nightly.yml b/.github/workflows/e2e-pw-nightly.yml
@@ -0,0 +1,60 @@
+name: E2E PW nightly
+
+on:
+  schedule:
+    - cron: '0 2 * * *' # every day at 2:00 AM
+  workflow_dispatch:
+
+jobs:
+  full:
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        shard: [1, 2, 3, 4]
+    env:
+      INTEGRATION_TEST_PRIVATE_KEY: ${{ secrets.INTEGRATION_TEST_PRIVATE_KEY }}
+      REACT_APP_NETWORK_URL_11155111: ${{ secrets.REACT_APP_NETWORK_URL_11155111 }}
+      REACT_APP_NETWORK_URL_1: ${{ secrets.REACT_APP_NETWORK_URL_1 }}
+      E2E_PW_MM_SEED: ${{ secrets.E2E_PW_MM_SEED }}
+      CI: 'true'
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        with:
+          node-version: lts/jod
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm --filter @cowprotocol/cowswap-e2e-pw exec playwright install --with-deps chromium
+      - run: pnpm --filter @cowprotocol/cowswap-e2e-pw exec playwright test --shard=${{ matrix.shard }}/4
+      - if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: playwright-report-shard-${{ matrix.shard }}
+          path: apps/cowswap-e2e-tests/playwright-report
+          retention-days: 14
+
+  notify-failure:
+    name: Notify Slack on Failure
+    needs: [full]
+    runs-on: ubuntu-latest
+    if: always() && failure()
+    permissions:
+      contents: read
+
+    steps:
+      - name: Notify Failure
+        run: |
+          curl -X POST -H "Content-type: application/json" --data "{\"text\": \"❌ E2E PW nightly failed on \`$REF_NAME\`. <$SERVER_URL/$REPOSITORY/actions/runs/$RUN_ID|See run $RUN_ID on GH>.\"}" "$SLACK_WEBHOOK_URL"
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_WEB_E2E_ALERT }}
+          REF_NAME: ${{ github.ref_name }}
+          SERVER_URL: ${{ github.server_url }}
+          REPOSITORY: ${{ github.repository }}
+          RUN_ID: ${{ github.run_id }}
diff --git a/.github/workflows/e2e-pw-smoke.yml b/.github/workflows/e2e-pw-smoke.yml
@@ -0,0 +1,45 @@
+name: E2E PW smoke
+
+on:
+  pull_request:
+    paths:
+      - 'apps/cowswap-frontend/**'
+      - 'apps/cowswap-e2e-tests/**'
+      - 'libs/**'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+
+concurrency:
+  group: e2e-pw-smoke-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    env:
+      INTEGRATION_TEST_PRIVATE_KEY: ${{ secrets.INTEGRATION_TEST_PRIVATE_KEY }}
+      REACT_APP_NETWORK_URL_11155111: ${{ secrets.REACT_APP_NETWORK_URL_11155111 }}
+      REACT_APP_NETWORK_URL_1: ${{ secrets.REACT_APP_NETWORK_URL_1 }}
+      E2E_PW_MM_SEED: ${{ secrets.E2E_PW_MM_SEED }}
+      CI: 'true'
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        with:
+          node-version: lts/jod
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm --filter @cowprotocol/cowswap-e2e-pw exec playwright install --with-deps chromium
+      - run: pnpm e2e:smoke
+      - if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: playwright-report
+          path: apps/cowswap-e2e-tests/playwright-report
+          retention-days: 7
diff --git a/.gitignore b/.gitignore
@@ -77,3 +77,6 @@ CLAUDE.md
 # Serena project files
 .serena/
 skills-lock.json
+
+# Subagent-driven-development scratch workspace (ledgers, briefs, review packages)
+.superpowers/
diff --git a/.mergify.yml b/.mergify.yml
@@ -2,15 +2,15 @@ queue_rules:
   - name: default
     conditions:
       - check-success=Deploy
-      - check-success=Cypress
+      - check-success=smoke
 
 pull_request_rules:
   - name: Merge approved and green PRs when tagged with 'Auto-merge'
     conditions:
       - '#approved-reviews-by>=2'
       - label="Auto-merge"
       - check-success=Deploy
-      - check-success=Cypress
+      - check-success=smoke
     actions:
       queue:
         method: squash

diff --git a/AGENTS.md b/AGENTS.md
@@ -65,6 +65,7 @@ Normative language:
 - Hardening roadmap (next enforcement steps): [`docs/HARNESS_HARDENING.md`](./docs/HARNESS_HARDENING.md)
 - Frontend-specific additive rules: [`apps/cowswap-frontend/AGENTS.md`](./apps/cowswap-frontend/AGENTS.md)
 - Other app-local commands/overrides: `apps/*/AGENTS.md`
+- E2E tests (Playwright): `apps/cowswap-e2e-tests/AGENTS.md`
 
 ## Branch-Scoped AGENTS Task Protocol
 

diff --git a/README.md b/README.md
@@ -147,31 +147,42 @@ pnpm run cosmos
 
 # 🤓 Development
 
-## Integration test
+## E2E tests
 
-> ⚠️ To run the tests. Make sure you add the required environment variables to
-> your root `.env.local` file with:
+CoW Swap's e2e suite lives in [`apps/cowswap-e2e-tests`](apps/cowswap-e2e-tests) (Playwright +
+Synpress). See that app's [README](apps/cowswap-e2e-tests/README.md) for the full guide — mocks, page
+objects, wallet fixtures, and troubleshooting.
+
+> ⚠️ Add the required environment variables to your root `.env.local` file:
 >
-> - `CYPRESS_INTEGRATION_TEST_PRIVATE_KEY=<your-private-key>`: Private key
-> - `CYPRESS_INTEGRATION_TESTS_INFURA_KEY=<your-infura-key>`: Infura key
-> - `CYPRESS_INTEGRATION_TESTS_ALCHEMY_KEY=<your-alchemy-key>`: Alchemy key (preferred if both are set)
+> - `INTEGRATION_TEST_PRIVATE_KEY=<a throwaway Sepolia private key>`
+> - `REACT_APP_NETWORK_URL_11155111=<a Sepolia RPC URL>`
 
-To launch it with our development server (so you have live-reloading):
+Most specs — including the PR smoke subset run in CI — use a fast mock wallet fixture and need no
+setup beyond the env vars above. A separate Synpress fixture drives a real MetaMask extension for
+scenarios that must exercise actual wallet UI; only specs using *that* fixture need a pre-built
+cache:
 
 ```bash
-# Terminal 1
-pnpm run start
-# Terminal 2
-pnpm run e2e
+pnpm e2e:build-cache
 ```
 
-If we want to use the Cypress UI, with the production build:
+> Neither the `e2e-pw-smoke` nor `e2e-pw-nightly` CI workflow runs this step — no spec in the
+> suite currently uses the Synpress fixture, so CI never touches `.cache-synpress`. If a spec
+> starts using it, its workflow must build or restore the cache first.
+
+Then run the suite. Playwright builds and serves the app itself, so there's no need to start a dev
+server in a separate terminal:
 
 ```bash
-# Terminal 1
-npx nx run cowswap-frontend:serve-static --port 3000
-# Terminal 2
-pnpm run e2e:open
+# Full suite
+pnpm e2e
+
+# PR smoke subset only
+pnpm e2e:smoke
+
+# Playwright UI mode, for interactive debugging
+pnpm e2e:ui
 ```
 
 ## Analyze build

diff --git a/apps/cowswap-e2e-tests/.env.example b/apps/cowswap-e2e-tests/.env.example
@@ -0,0 +1,3 @@
+REACT_APP_NETWORK_URL_11155111=https://ethereum-sepolia-rpc.publicnode.com
+REACT_APP_NETWORK_URL_1=https://ethereum-rpc.publicnode.com
+INTEGRATION_TEST_PRIVATE_KEY=0x000000
diff --git a/apps/cowswap-e2e-tests/.gitignore b/apps/cowswap-e2e-tests/.gitignore
@@ -0,0 +1,8 @@
+node_modules/
+dist/
+test-results/
+playwright-report/
+.playwright/
+.cache-synpress/
+coverage-report.md
+.env