decocms/studio/qa-screenshot

qa-screenshot — see the change, then show it

A browser is installed globally in the sandbox, NOT in the repo's node_modules — don't go looking for playwright there.

Capture

qa-screenshot <url> /app/org/output/qa/<name>.png [--mobile] [--full] [--selector=<css>] [--console]

• Renders any URL, localhost included, in headless Chromium and runs the page's JS.
• Framing: default is the top viewport, --full the whole page, --selector='<css>' just the component you changed (best for a focused before/after).
• --mobile is a real phone viewport AND a mobile user-agent, not a narrowed desktop. Capture both desktop and mobile for a responsive change.
• --console also reports the page's runtime errors, which a screenshot alone shows as a pass.
• Deep-link to the page the change affects, not the site root.
• No dev server runs by default. Start one yourself to capture localhost.
• --engine=webkit renders in WebKit (Safari's engine) — use it when a mobile scroll, snap or animation quirk could be engine-specific, or when asked to check Safari. It is not a real iPhone or Mac: report it as "checked in WebKit", not as tested on iOS or Safari.

Look at it

Read every file you wrote. A screenshot you never opened is not verification.

Show it

Write under /app/org/output/ and embed the shots in your task comment as markdown images. Only that form renders on the card; a bare path or a code span shows the reader nothing. Put a before/after pair in a two-column table so they render side by side:

| Before | After |
| --- | --- |
| ![before desktop](/app/org/output/qa/before-desktop.png) | ![after desktop](/app/org/output/qa/after-desktop.png) |

Interact

To click, fill a form or hit-test with document.elementFromPoint, write a throwaway node script against the global playwright-core:

const { chromium } = require("/usr/local/lib/node_modules/playwright-core");
const browser = await chromium.launch({
  executablePath: "/usr/bin/chromium",
  args: ["--no-sandbox"],
});

For WebKit, use webkit from the same playwright-core with browser.newContext(devices["iPhone 13"]).

Don't report a check as impossible because Playwright is missing — it is installed.