OpenParable
Skip to content
← Back to skills

Playwright UX UI Capture

Testing & Quality
playwright-ux-ui-capture

Playwright UX UI Capture is an Agent Skill for testing & quality published in the raphaelmansuy/edgequake repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Capture EdgeQuake WebUI routes with Playwright and write artifacts immediately (screenshots + per-page request JSON + capture index). Use when adding/updating Playwright E2E capture specs or when asked to automate UI screenshot collection.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/raphaelmansuy/edgequake/blob/HEAD/.github/skills/playwright-ux-ui-capture/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/playwright-ux-ui-capture, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Playwright UX/UI Capture (Artifact-first)

When to use

Use this skill when implementing or modifying Playwright E2E to:

  • capture screenshots for a set of routes
  • emit per-route artifacts immediately to disk
  • keep the process robust and deterministic

Repo conventions

  • Playwright config: edgequake_webui/playwright.config.ts
  • Tests live in: edgequake_webui/e2e/
  • UX/UI output dir: ux_ui_map/ (repo root)

Route discovery

Prefer enumerating concrete page.tsx files under edgequake_webui/src/app/**/page.tsx.

  • Ignore route groups: folders like (dashboard) do not appear in URL paths.
  • Avoid dynamic segments: paths with [param], [...param], [[...param]] are not capturable without fixture data.

Helper script (no dependencies):

Example:

node .github/skills/playwright-ux-ui-capture/scripts/derive_routes.mjs --format json

Viewports (required)

Capture exactly these 3 widths (use a reasonable height):

  • desktop: 1440px
  • tablet: 768px
  • mobile: 375px

Waiting strategy (important)

  • Prefer Playwright auto-waits + a stable “page ready” signal (e.g. a visible main or h1).
  • Avoid relying on waitForLoadState('networkidle') as the primary sync.

Artifact write-out (must be immediate)

For each route:

  1. create ux_ui_map/screenshots/{page}/
  2. write desktop.png, tablet.png, mobile.png
  3. write/update ux_ui_map/requests/{page}.json from the template
  4. append one JSON line to ux_ui_map/capture-index.jsonl

How to run

From repo root:

  • cd edgequake_webui && npm run test:e2e

To run a single spec (preferred while iterating):

  • cd edgequake_webui && npx playwright test e2e/<spec>.spec.ts

Output example (capture index)

Each line is a standalone JSON object:

{"page":"dashboard","route":"/","capturedAt":"2025-12-26T12:34:56.000Z","ok":true}

Common failure handling

  • If a page requires auth, capture /login first and then attempt the route.
  • If a route 404s, still write a capture-index line with ok:false and store a screenshot of the error state.