Design fixture

QA command block

Show exact command, checks performed, generated report, and pass/fail meaning.

Good Example

A command block displays npm run qa:browser, screenshots/report paths, checked viewports, and what fails the run.

pass npm run qa:browser

Checks desktop/mobile screenshots, visible H1s, overflow, accessible names, image alt text, duplicate IDs, and focus-visible styles.

Report: reports/browser/browser-visual-report.json

Bad Example

A button labeled Run QA without command text, report path, or explanation of what the result proves.

Ambiguous decorative status without enough context, source, or command evidence.

States

  • ready
  • running
  • pass
  • warning
  • fail

Responsive Constraint

Command text wraps or scrolls in a bounded code surface on mobile.

Accessibility Constraint

Status is conveyed by text, not color alone, and the command is selectable.

Agent Check

Can an agent copy the command and know what evidence file should exist after it runs?

QA Gates

  • npm run qa:browser
  • npm run qa:handoff