# ra > ra opens your web app in Chromium, inside a fake world you describe, and tells your coding agent in sentences what a person would find wrong: text cut off, a button that something else covers, grey text too pale to read, or a page that scrolls sideways on a phone. It is UI testing for agents, made to run in the middle of a change. Catch the UI bugs your agent can't see. Each page below is Markdown, and [llms-full.txt](https://hraness.github.io/ra/llms-full.txt) holds them all in one file. ## Overview - [Start](https://hraness.github.io/ra/docs/start.md) - [What it finds](https://hraness.github.io/ra/docs/what-it-finds.md): Each finding is one sentence that names the element and, where it can, says by how much. - [How it works](https://hraness.github.io/ra/docs/how-it-works.md): ra has two halves, and your app runs unchanged between them. - [When to use it](https://hraness.github.io/ra/docs/when-to-use-it.md): A browser check costs more than a unit test: each look loads the page in a real browser and waits for it to settle, and browser tests flake more than most. ## Guides - [Setting up](https://hraness.github.io/ra/docs/setting-up.md): ra needs Node 22.18 or later and a Playwright in your project: playwright-core, playwright, or @playwright/test. - [For coding agents](https://hraness.github.io/ra/docs/for-coding-agents.md): ra comes with a skill, skills/ra/SKILL.md, that teaches a coding agent when to reach for ra and how to read what it prints. - [In CI](https://hraness.github.io/ra/docs/in-ci.md) - [Recipes](https://hraness.github.io/ra/docs/recipes.md): Choosing states and views, and setting ra up for each kind of app, from a static site to a desktop app's web surfaces. ## Reference - [Reference](https://hraness.github.io/ra/docs/reference.md) - [Findings](https://hraness.github.io/ra/docs/findings.md): How each kind of finding is decided, what it deliberately ignores, and how to accept one. - [The skill](https://hraness.github.io/ra/docs/skill.md): When a coding agent should look, and how it reads what ra prints. ## Background - [How it compares](https://hraness.github.io/ra/docs/how-it-compares.md): An agent that wants to know whether its UI change worked has three easy options, and each misses something. - [Design decisions](https://hraness.github.io/ra/docs/design-decisions.md): How it compares argues the three largest choices: measure instead of asking a model, close the world, and put measured findings beside the outline. - [Verification](https://hraness.github.io/ra/docs/verification.md): Each release on GitHub is immutable, with the packed tarball as its one asset, and GitHub records the asset's SHA-256. - [From Direct to ra](https://hraness.github.io/ra/docs/from-direct.md): ra replaces Direct, an earlier Hraness framework that also gave each state of an app its own URL in a fixture world. This page says what ra kept, what it dropped, and why.