ra
All pages

What it finds

View Markdown
For agents

This page is also Markdown. llms.txt lists every page, and llms-full.txt holds them all in one file. The skill teaches a coding agent to run ra by itself.

Each finding is one sentence that names the element and, where it can, says by how much.

A phone screenshot of ra's broken fixture page with seven numbered problems, beside the sentences ra printed for them: the page scrolls sideways by 531px, a button's label is cut off by 84px, a long word runs 119px past its box, two lines are drawn over each other, a Pay now button is covered by another element, two tap targets are 18 by 18 pixels, and grey text has 1.9:1 contrast.

That is ra look broken --at phone on a fixture page of planted problems. It printed 37 findings, and the picture shows seven. There are 19 kinds:

  • Layout
    • page-scroll: the page scrolls sideways.
    • cut-off: text or a control is clipped by a box that hides overflow.
    • spill: text runs out of its box.
    • overlap: two pieces of text are painted over each other.
    • covered: something sits on top of a control, so a click would land on that instead.
  • Reading and reaching
    • contrast: text has too little contrast with what is painted behind it.
    • small-target: tap targets on touch views are small and crowded.
    • no-name: a control has no accessible name, or an image has no alt text.
  • Content
    • image: an image did not load, or is stretched.
    • blank: the page shows nothing.
    • document: there is no title or viewport, or the status is unexpected.
    • error-overlay: a dev-server error overlay is showing.
  • Behaviour
    • console: an error was logged.
    • request: a request failed or answered 4xx/5xx.
    • outside: a request left the world.
    • load: the page did not load.
    • busy: the page never went quiet.
    • expect and steps: your own checks or steps failed.

A false alarm sends an agent to change a page that was right, so ra counts one as a bug. Its twin fixture, tricky.html, holds 14 sections of things that only look wrong, such as deliberate ellipses, line clamps, scrolling strips, off-screen drawers, and screen-reader-only text. ra's tests fail if it reports anything there, at desktop or phone size, in dark mode, with scripts off, or after a jump down the page. docs/findings.md says how each kind is decided, what it deliberately leaves alone, and how to accept one.