Skip to content

Add a2ui-oat: framework-free web renderer (v0.9)#1032

Open
MisterTK wants to merge 2 commits intogoogle:mainfrom
MisterTK:add-a2ui-oat-renderer
Open

Add a2ui-oat: framework-free web renderer (v0.9)#1032
MisterTK wants to merge 2 commits intogoogle:mainfrom
MisterTK:add-a2ui-oat-renderer

Conversation

@MisterTK
Copy link
Copy Markdown

Add a2ui-oat to Community Renderers

a2ui-oat is a lightweight, framework-free A2UI renderer for the web, built on Oat CSS semantic styling.

What it provides

  • 37 catalog components — all 16 basic catalog components plus 21 Oat-native extensions (tables, pagination, progress, meter, skeleton loaders, toasts, tooltips, alerts, breadcrumbs, sidebars, accordions, switches, badges, avatars, video, audio, grid, dropdown, autocomplete, OatHTML escape hatch)
  • 22 registered client-side functions — data (fetchPage, fetchAndAppend, subscribeSSE, subscribeWebSocket), navigation (openUrl, navigateTo), UI (showToast, debounce), formatting (formatDate, formatNumber, formatString, formatCurrency, pluralize), logic (and, or, not), validation (required, regex, length, numeric, email)
  • ~13KB total client footprint — Oat CSS + JS + companion libraries, minified and gzipped
  • Zero framework dependencies — no React, Angular, Lit, or build tooling required
  • Custom catalog with theme support (7 properties mapped to CSS custom properties)
  • @a2ui/web-lib integration via registerWithWebLib() one-call setup
  • Dual-mode architecture — A2UI Mode (structured, catalog-validated) and Direct Mode (trusted agents emit semantic HTML)

Why this fills a gap

Every existing web renderer in the registry targets a framework (React, Lit, Angular). a2ui-oat is the first framework-free option — deploy via CDN include or npm install, no build step required. This makes it the lowest-friction path for agents that need to render A2UI on the web.

Links

Spec version

v0.9 only. Uses createSurface, updateComponents, updateDataModel message format with custom catalog support.

License

MIT

@google-cla
Copy link
Copy Markdown

google-cla bot commented Mar 29, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds the a2ui-oat renderer to the ecosystem documentation, updating the community renderer table and providing a detailed description of its features. Feedback was provided to shorten the description of a2ui-oat to maintain consistency with other entries in the document.


**a2ui-swiftui** is a native SwiftUI renderer supporting iOS, macOS, visionOS, watchOS, and tvOS. It covers all 18 standard A2UI components with dual v0.8 + v0.9 protocol support, includes JSONL streaming, and uses the Observation framework for reactivity.

**a2ui-oat** is the first framework-free web renderer, built on [Oat CSS](https://oat.ink/) semantic styling. It maps 37 catalog components (all 16 basic + 21 extensions) to semantic HTML with zero framework dependencies (~13KB total client footprint). It includes 22 registered client-side functions (pagination, SSE streaming, WebSocket, routing, formatting, validation), a custom catalog with theme support, and a dual-mode architecture that also supports direct HTML rendering for trusted agents. v0.9 only, with `@a2ui/web-lib` integration via `registerWithWebLib()`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This highlight description is quite detailed compared to the others in this section. To maintain consistency across the document and improve scannability, please consider shortening it to be a similar length to the other entries (2-3 sentences).

Here is a suggested revision that captures the key features more concisely:

Suggested change
**a2ui-oat** is the first framework-free web renderer, built on [Oat CSS](https://oat.ink/) semantic styling. It maps 37 catalog components (all 16 basic + 21 extensions) to semantic HTML with zero framework dependencies (~13KB total client footprint). It includes 22 registered client-side functions (pagination, SSE streaming, WebSocket, routing, formatting, validation), a custom catalog with theme support, and a dual-mode architecture that also supports direct HTML rendering for trusted agents. v0.9 only, with `@a2ui/web-lib` integration via `registerWithWebLib()`.
**a2ui-oat** is the first framework-free web renderer, built on [Oat CSS](https://oat.ink/) semantic styling. It provides 37 components and 22 client-side functions with a minimal footprint (~13KB). Key features include a custom catalog with theme support, a dual-mode architecture, and `@a2ui/web-lib` integration. v0.9 only.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

1 participant