diff --git a/.gitignore b/.gitignore
index 099f161..fd29395 100644
--- a/.gitignore
+++ b/.gitignore
@@ -49,3 +49,8 @@ demo/seed_demo.py
 # Git worktrees
 .worktrees/
 .env.e2e
+
+# E2E test result artifacts
+tests/e2e/results/demo/
+tests/e2e/results/cloud/
+tests/e2e/results/local/
diff --git a/requirements.txt b/requirements.txt
index d3e9dad..44c5506 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -13,6 +13,8 @@ streamlit-paste-button>=0.1.0
 # ── Job scraping ──────────────────────────────────────────────────────────
 python-jobspy>=1.1
 playwright>=1.40
+pytest-playwright>=0.4
+pytest-json-report>=1.5
 selenium
 undetected-chromedriver
 webdriver-manager
diff --git a/tests/e2e/__init__.py b/tests/e2e/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/tests/e2e/modes/__init__.py b/tests/e2e/modes/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/tests/e2e/pages/__init__.py b/tests/e2e/pages/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/tests/e2e/results/.gitkeep b/tests/e2e/results/.gitkeep
new file mode 100644
index 0000000..e69de29