All pages
Setting up
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:
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 chromiumTo 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:
npx ra look https://example.com/pricing --at phone.darkTo name states, add ra.config.ts at the project root:
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:
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 diffNode 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.