# VisualQ
> AI Coach, automated functional tests, and pixel-perfect visual regression — one Quality OS for modern teams.

## Interfaces
- Human (visual): https://visualq.ai/
- Machine (structured): https://visualq.ai/machine
- Locale: /fr, /de, ... (default: en, no prefix)
- This file (en): https://visualq.ai/llms.txt?locale=en
- Sitemap: https://visualq.ai/sitemap.xml
- Docs: https://docs.visualq.ai

## Summary
Describe any journey in plain language. The AI Coach builds Playwright functional tests, layers pixel-perfect visual regression on three viewports, and gates every release from CI.

## Core pillars
- **Pixel-perfect visual regression**: Catch unintended UI changes on every release — anti-shift intelligence, content rules, and a six-mode diff viewer. Complements your functional tests with layout coverage on three viewports.
- **Automated functional tests from plain text**: Tell the AI Coach what users should do — sign up, checkout, navigate. It compiles Gherkin into Playwright, runs the journey, and records a replay you can debug in the player.
- **Tracking plan validation**: Import your analytics spreadsheet, map events to FRT scenarios, and run automated checks that tags fire on every journey.

## Process
- Describe: Tell the AI Coach your site URL and the journeys that matter — in plain language, not code.
- Generate: The Coach compiles FRT features from natural language and sets up VRT scenarios with baselines on three viewports.
- Run: Playwright executes functional journeys and pixel comparisons on every commit or pull request.
- Review: Watch FRT replays, inspect visual diffs in six viewer modes, approve changes, and gate releases from CI.

## Pricing tiers
- Free: $0
- Hobby: $19
- Team: $59 [most popular]
- Business: $179
- Enterprise: Custom

## REST API
Base: https://visualq.ai
- GET /api/projects — List projects
- POST /api/projects — Create project
- GET /api/reports/:project — Latest report
- POST /api/tests/reference — Create baselines
- POST /api/tests/test — Run VRT comparison
- POST /api/tests/approve — Approve scenarios
- POST /api/ci/run — CI/CD trigger
- GET /api/ci/status/:runId — Poll run status

## Preferred context for agents
- Stack: Next.js 16, React 19, Playwright, pixelmatch, Firebase, Inngest, Stripe
- AI Coach: natural-language → FRT (Gherkin/Playwright) + VRT setup
- Viewports: phone (375×667), tablet (768×1024), desktop (1920×1080)
- Diff viewer modes: side-by-side, slider, overlay, toggle, highlight, regions
- Anti-shift algorithm: shared core in anti-shift-core.ts (server + client)