Human-facing React components built on Base UI and Tailwind CSS, with agent-readable contracts and optional tests.
One message in a chat: who wrote it, their avatar and what they wrote, with any attachments under it.
A conversation: `Message`s in a scrolling, labeled region that opens at the newest one.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for message-list, and the tests of everything it installs. Add it beside message-list: add message-list message-list-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for message, and the tests of everything it installs. Add it beside message: add message message-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A moment in an app's life, shown in the space it is given: nothing here yet, on its way, something failed, a first run, or something finished.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for moment, and the tests of everything it installs. Add it beside moment: add moment moment-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A labeled native `<select>` on the Field contract: pass `label`, `options` (or `<option>` children) and `error`.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for native-select, and the tests of everything it installs. Add it beside native-select: add native-select native-select-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
The bar across the top of an app: your brand, the main links and a few controls, with the current page marked `aria-current="page"`, and the link of the section it is in `aria-current="true"`, both underlined in the primary colour as in `FamilyBar`, distinct from hover and press highlights.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for navbar, and the tests of everything it installs. Add it beside navbar: add navbar navbar-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A row of links where some open a panel of further links, each with a line of description: the navigation of a site with more pages than fit in a bar.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for navigation-menu, and the tests of everything it installs. Add it beside navigation-menu: add navigation-menu navigation-menu-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
The vertical bar of the app's top-level pages on the start edge of a wide screen, as in a chat or mail app or an editor's activity bar: each item an icon over a short label, the current one with its `currentIcon`, a bar on the rail's edge and `aria-current="page"`.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for navigation-rail, and the tests of everything it installs. Add it beside navigation-rail: add navigation-rail navigation-rail-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A labeled number input on the Field contract: pass `label`, and `error` from your server action or client check.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for number-field, and the tests of everything it installs. Add it beside number-field: add number-field number-field-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A one-time code entry on the Field contract: one slot per character, with focus that moves as the person types, a whole code pasted at once, and `autoComplete="one-time-code"` so phones offer the code from a text message.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for otp-field, and the tests of everything it installs. Add it beside otp-field: add otp-field otp-field-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
Ouro AX, the agent-experience kit, in one item: the ax-* items, from one command definition to the X-ray that checks an interface against the claims.
Optional: Ouro AX with the ax-* tests, the X-ray's fixtures and the example tool.
Add it once per app, before your first component; no component installs it, so later adds never touch your stylesheet. What every Ouro UI component needs in the app's CSS: success and warning colors, a destructive foreground, the field border color (--input) and --radius when your theme has none, the motion tokens, the press utility, the keyframes for spinners, progress bars and skeletons, and --ouro-layer, the z-index of sheets and dialogs (50; raise it in a :root rule of your own if your app has fixed bars above z-50).
Optional: the census journey kit. A Playwright spec of yours lists the pages your app renders and the states a person can open on them; the census records the exact multiset of visible controls in each (role, name, Ouro marker, context) and fails on any change from the committed baseline, and on any unmarked control in a journey you enrol. Unmarked controls may only fall, state by state. It installs e2e/ouro-census/ (the spec helper, the merge, the baseline update and a comparison of two runs).
Optional: the screen check. It opens every page of a built folder or a URL in headless Chromium at every screen size from 320 to 3840 wide, light and dark, and finds overlap, sideways scroll, clipped text, blurry pictures, pictures that fade into the page and serious axe-core violations, and long lines only where ouro-check.json declares a measure, each with a captioned close-up and a contact sheet per page. It measures layout shift while loading, the time to the first content and each press's time to paint, each against a budget, and records each number in its report. A run split with --shard k/n and joined with merge finds what one run does. Its fades.ts finds every gradient used as a mask in your source, and every wash laid over a picture, so no picture fades into the page. It installs scripts/ouro/check/.
Optional: the picture sizes. It writes each raster picture in a folder as AVIF and WebP at each width up to its own, with sharp, and images.json with the srcset of each, for a <picture> element. It installs scripts/ouro/images/.
Every helper in lib/ouro in one item. You don't need to add it: each component installs only the helpers it imports (the lib-<name> items).
Optional: the tests of every helper in lib/ouro, with ouro-lib. You don't need to add it: each -tests item installs the tests of the helpers its component imports. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
The view an MCP server returns for agent-composed UI (MCP Apps): the host, such as Claude or ChatGPT, frames it, and it shows the latest tool result's card: Ouro's composed tree in `structuredContent.ouro` with ComposedSurface, once it passes core's `validateTree` against the catalog, or A2UI messages in `structuredContent.a2ui` with `A2UISurface`.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for ouro-mcp-app, and the tests of everything it installs. Add it beside ouro-mcp-app: add ouro-mcp-app ouro-mcp-app-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
Ouro UI's states as classes, for markup that is not an Ouro component, such as rows and controls a page builds as strings or prerenders to read without a script: the focus ring, a linked row, a disclosure, a skip link, actions shown on hover or focus, current links, toggles, segmented choices and options. Add it once, after ouro-base, only if your app has such markup.
Optional: the hand-rolled-control source rule. It reads your app's source with the TypeScript compiler and its stylesheets with PostCSS, and finds the controls still built by hand (a raw <button>, <a>, <input>, a click handler on a <div>, another UI library's control, control-state styling) and every component that wraps one, as fingerprints held to a committed baseline that may only shrink. It installs scripts/ouro-source-rules.mjs.
Installed with every -tests item; you don't need to add it. The test kit Ouro UI's tests use: Vitest browser projects with the drag, flick, tap, doubleTap, touchDrag, touchStep, pointerPress, emulateMedia, pageZoom, resetPageZoom, setPageZoom and restoreTouch commands, the rotate helper (which turns the phone viewport and resets Chromium's zoom; the ouro-touch project fails a test that leaves the page zoomed), the act helper, the holdFrames helper (which holds animation frames and the clock still so a test steps a spring itself), the motion helpers (expectMotion, expectNoMotion, expectGestureSettle, expectTransition and parseDuration, which prove exactly which CSS properties a state change runs on each part), watchAnnouncements (which records what live regions announce, so a test proves a message is heard once per change), axeExclude, and the end-to-end story helper.
Optional: every Ouro UI component with its tests, type tests, stories and Playwright spec, and the test kit. The whole suite in one command. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
Ouro UI's own look, as a shadcn theme for :root and .dark. Skip it to keep your app's theme.
The top of a page: its title with an optional line above it (`eyebrow`), a description under it, the page's actions beside it, and a trail and an image above.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for page-header, and the tests of everything it installs. Add it beside page-header: add page-header page-header-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
Page navigation for a long list: Previous, the page numbers with gaps, and Next, with the current page marked `aria-current="page"`.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for pagination, and the tests of everything it installs. Add it beside pagination: add pagination pagination-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A small non-modal panel beside its trigger, for a short form or a few choices: a share link, filters, a quick edit.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for popover, and the tests of everything it installs. Add it beside popover: add popover popover-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
The status spot: a small round window with one line about how current the app's data is, which opens into the facts behind it.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for porthole, and the tests of everything it installs. Add it beside porthole: add porthole porthole-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A bar that shows how far along a task is, or that it is under way when you can't tell.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for progress, and the tests of everything it installs. Add it beside progress: add progress progress-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A group of radios under one legend, on the Field contract, for picking exactly one choice: pass `legend`, and `options` (or `Radio` children).
Optional: the Vitest browser tests, type tests, stories and Playwright spec for radio-group, and the tests of everything it installs. Add it beside radio-group: add radio-group radio-group-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
A message's reactions: each one's emoji and how many chose it, with the person's own pressed and tinted, and quick reactions to add with a single press.
Optional: the Vitest browser tests, type tests, stories and Playwright spec for reaction-bar, and the tests of everything it installs. Add it beside reaction-bar: add reaction-bar reaction-bar-tests. It names Vitest, Playwright and Storybook without a version, so the CLI installs one only when your app lacks it and never changes a version you have.
How long ago (or how soon) something happens, in the reader's language: "3 days ago", "yesterday", "in 5 minutes", "now", kept current while it shows.