ra
All pages

Setting up

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.

ra needs Node 22.18 or later and a Playwright in your project: playwright-core, playwright, or @playwright/test. With Bun, install it like this:

Terminal
bun add -d https://github.com/hraness/ra/releases/download/v0.1.6/hraness-ra-0.1.6.tgz playwright-core
bunx --no-install playwright-core install chromium

To upgrade, give the new release's address the same way. npm replaces the old one: npm install -D <new address>. Bun stops with DependencyLoop while its lockfile names the old address, so remove ra and add it again (bun remove @hraness/ra, then bun add -d <new address>), or change the address in package.json and run bun install.

ra look also takes the address of a deployment:

Terminal
npx ra look https://example.com/pricing --at phone.dark

To name states, add ra.config.ts at the project root:

ra.config.ts
import { defineConfig } from "@hraness/ra";

export default defineConfig({
  app: { command: "bun run dev --port {port}" },
  views: ["desktop", "phone", "phone.dark"],
  world: {
    allow: ["fonts.googleapis.com", "fonts.gstatic.com"],
    block: ["*.posthog.com"],
    replies: { "GET /api/me": { json: { name: "Ada" } } },
  },
  states: {
    home: "/",
    pricing: "/pricing",
    "inbox-empty": { url: "/inbox", world: { replies: { "GET /api/messages": { json: [] } } } },
    "inbox-down": {
      url: "/inbox",
      world: { replies: { "GET /api/messages": { status: 500, json: { error: "down" } } } },
      see: ["Something went wrong"],
    },
    "long-name": {
      url: "/settings",
      world: { replies: { "GET /api/me": { json: { name: "Wolfeschlegelsteinhausenbergerdorff" } } } },
    },
  },
});

Then:

Terminal
npx ra states                     # what this project names
npx ra look inbox-empty --at phone
npx ra check                      # every state through every view; exits 1 on findings
npx ra snap && $EDITOR app.css && npx ra diff

Node strips the types from ra.config.ts, so relative imports in it need their .ts extension, and it cannot use path aliases. Recipes covers choosing states and views for each kind of app.