p19-bug-fixes

e2e/README.md

@@ -0,0 +1,62 @@
+# ClawFort UI/UX Regression Test Suite
+
+Playwright-based end-to-end testing for ClawFort AI News application.
+
+## Quick Start
+
+```bash
+# Install dependencies and browsers
+cd e2e
+npm install
+npm run install:browsers
+
+# Run smoke tests (fast feedback)
+npm run test:smoke
+
+# Run full regression suite
+npm run test:full
+
+# Run with UI mode for debugging
+npm run test:ui
+
+# Run in headed mode (see browser)
+npm run test:headed
+```
+
+## Test Organization
+
+```
+tests/
+├── fixtures/           # Shared test fixtures and utilities
+├── capabilities/       # Tests organized by capability
+│   ├── core-journeys/       # Hero/feed browsing, modal flows
+│   ├── accessibility/       # WCAG 2.2 AA compliance
+│   ├── responsive/          # Mobile/tablet/desktop
+│   ├── modal-experience/    # Summary modal interactions
+│   └── microinteractions/   # Share, contact, tooltips
+├── smoke/              # Fast smoke tests for PR gates
+└── e2e.spec.ts         # Main test entry point
+```
+
+## Environment Variables
+
+- `BASE_URL`: Target application URL (default: http://localhost:8000)
+- `CI`: Set to true for CI-specific behavior
+
+## Test Profiles
+
+### Smoke Profile
+- Runs on every PR
+- Covers critical paths: hero loading, modal open/close, basic accessibility
+- ~2-3 minutes execution time
+
+### Full Profile
+- Runs on main/nightly builds
+- Complete capability coverage across all themes and breakpoints
+- ~15-20 minutes execution time
+
+## CI Integration
+
+Tests are integrated into GitHub Actions workflow:
+- PR Quality Gate: Smoke profile must pass
+- Main/Nightly: Full profile with artifact retention