ghost-qa is a local headless Playwright browser verification CLI and MCP server that inspects running web applications across Desktop (1440x900), Tablet (768x1024), and Mobile (375x812) viewports. Its 8-Trap Engine detects console exceptions, React/Next.js hydration mismatches, failed network requests (4xx/5xx), dead interactions, horizontal viewport overflow, bounding-box element collisions, accessibility violations, and dark-mode contrast failures.
375px overflow, overlapping sticky headers, or client-side hydration errors.http://localhost:3000, http://localhost:5173, etc.).Use an authorized disposable localhost application with test data. The browser can navigate and interact with controls and forms, and the CLI writes reports. Keep production services, credentials, and webhooks disconnected. Review the pinned package and get authorization before installing dependencies or running the browser interactions. Install Chromium separately if required, following the upstream setup guide.
~~~bash
npx -y ghost-qa@2.1.2 test http://localhost:3000 --out-dir ghost-qa-out
~~~
0-100 QA Health Score, per-viewport trap breakdown, and report.html artifact.scrollWidth > clientWidth overflow, bounding-box overlaps, console errors, or missing ARIA labels.~~~bash
npx -y ghost-qa@2.1.2 test http://localhost:3000 --out-dir ghost-qa-out
~~~
ghost-qa reports 0 uncaught console/page errors and 0 hydration mismatches.1440x900), Tablet (768x1024), and Mobile (375x812) viewports have zero horizontal overflow or overlapping interactive elements.For a disposable local dashboard with a mobile overflow report, run the viewport check, inspect the first overflow finding in the HTML report, then rerun after correcting the responsible component.