frontend-e2e

/frontend-e2e — Comprehensive Frontend E2E Live Test

Perform a thorough live E2E test of a frontend web application using browser-bridge MCP tools. Tests every page, interactive element, form, navigation flow, responsive breakpoint, and accessibility rule through real browser interaction.

Architecture: Detect -> Crawl -> Universal -> A11y -> Visual/UX -> Navigation -> Responsive -> Interactive -> Performance -> Report. $0 cost, fully local via browser-bridge.

CRITICAL: Execute the full test silently. Only interact with the user in Step 0 (URL/env confirmation) and Step 0.5 (auth probe). Present the full report at the end.

IMPORTANT: Per-page error isolation is MANDATORY. Every page's test suite is wrapped in error handling — if any test fails or errors, mark it FAIL and continue to the next page/test. NEVER abort the full run because of a single page failure.

Input

$ARGUMENTS = URL [flags]

Flag	Description	Default
--focus <path>	Test only pages matching this path prefix	all pages
--skip-a11y	Skip accessibility checks (Tier 1.5)	enabled
--skip-responsive	Skip responsive/breakpoint tests (Tier 3)	enabled
--max-pages <n>	Override default page cap	20
--deep	Set page cap to 50 instead of 20	off
--auth-cookie <name=value>	Inject a session cookie before crawl	none
--skip-visual	Skip visual/UX quality checks (Tier 1.7)	enabled
--skip-design	Skip visual design quality checks (Tier 1.8)	enabled
--allow-submit	Allow form submission (localhost/staging only)	off

---

Step 0: Detect Application — MANDATORY, SILENT

1. Parse $ARGUMENTS for URL and flags
2. If no URL: probe common dev server ports (3000, 3001, 4200, 5173, 5174, 8000, 8080) via mcp__browser-bridge__browser_navigate to http://localhost:{port} — use first that responds
3. If still no URL: STOP — "Provide a URL or start a local dev server"
4. Call mcp__browser-bridge__browser_get_tabs to verify browser-bridge connection. If fails: STOP — "Browser-bridge not connected. Check Chrome extension."
5. Production safety gate: If URL is NOT localhost, 127.0.0.1, or does NOT contain staging/dev/test in hostname:
   • Present warning: "This appears to be a production URL. Interactive tests (Tier 4) will NOT submit forms. Use --allow-submit only for test/staging environments."
   • Set internal flag SAFE_MODE = true (no form submissions, no button clicks that trigger navigation away)
6. Navigate to URL via mcp__browser-bridge__browser_navigate
7. Wait for page: try mcp__browser-bridge__browser_wait_for_element targeting body (timeout 15s). Known issue: wait_for_element may return "restricted URL" on localhost — if so, fall back to browser_evaluate with !!document.body check + 2s delay as workaround.
8. Take baseline screenshot via mcp__browser-bridge__browser_screenshot