From deced0d9ae19cc27c4ae30ea82d59b6494dc9252 Mon Sep 17 00:00:00 2001 From: alan bount Date: Tue, 28 Apr 2026 21:38:35 +0000 Subject: [PATCH 1/3] Docs: Rename Standard Catalog to Basic Catalog and update v0.9 status Rename 'Standard Catalog' and related terms to 'Basic Catalog' across the documentation files to align with the v0.9 specifications. Update v0.9 status from 'Draft' to 'Current' in index and introduction files. Update React renderer status for v0.9 to 'Stable' in renderers reference. TAG=agy CONV=97210f91-e190-45b1-ac9b-32bb0e86d314 --- docs/concepts/catalogs.md | 4 +- docs/concepts/components.md | 2 +- docs/ecosystem/a2ui-in-the-world.md | 2 +- docs/ecosystem/renderers.md | 2 +- docs/guides/renderer-development.md | 16 +-- docs/index.md | 2 +- docs/introduction/what-is-a2ui.md | 2 +- docs/reference/components.md | 2 +- docs/reference/messages.md | 2 +- docs/reference/renderers.md | 2 +- docs/roadmap.md | 155 +++++++++++----------------- 11 files changed, 76 insertions(+), 115 deletions(-) diff --git a/docs/concepts/catalogs.md b/docs/concepts/catalogs.md index 0bc11a883..814d77267 100644 --- a/docs/concepts/catalogs.md +++ b/docs/concepts/catalogs.md @@ -59,7 +59,7 @@ Whether you are building a simple prototype or a complex production application, To help developers get started quickly, the A2UI team maintains the [Basic Catalog](../../specification/v0_9/json/basic_catalog.json). -This is a pre-defined catalog file that contains a standard set of general-purpose components (Buttons, Inputs, Cards) and functions. It is not a special "type" of catalog; it is simply a version of a catalog that we have already written and have open source renderers for. +This is a pre-defined catalog file that contains a basic set of general-purpose components (Buttons, Inputs, Cards) and functions. It is not a special "type" of catalog; it is simply a version of a catalog that we have already written and have open source renderers for. The basic catalog allows you to bootstrap an application or validate A2UI concepts without needing to write your own schema from scratch. It is intentionally sparse to remain easily implementable by different renderers. @@ -389,7 +389,7 @@ Here is how catalog version mismatches are handled in practice: - **An old iOS client is using an older catalog than the agent** - The agent sends a new component `Badge` that the old iOS client doesn't know about. The client renders a generic textbox placeholder or safe text description for it, keeping the rest of the interface functional. - - The agent sends a new property `badge` on a `Button` that an old client doesn't know about. The client safely ignores it and renders the standard button. + - The agent sends a new property `badge` on a `Button` that an old client doesn't know about. The client safely ignores it and renders the basic button. - The agent no longer sends the `Facepile` component that was removed in a later catalog version. This causes no issues for the client. - **A web client rolls out a new catalog version ahead of the agent** diff --git a/docs/concepts/components.md b/docs/concepts/components.md index 8cb28a44e..6b0e6a5e1 100644 --- a/docs/concepts/components.md +++ b/docs/concepts/components.md @@ -173,7 +173,7 @@ Every component has: To help developers get started quickly, the A2UI team maintains the [Basic Catalog](../../specification/v0_9/json/basic_catalog.json). -This is a pre-defined catalog file that contains a standard set of general-purpose components (Buttons, Inputs, Cards). It is not a special "type" of catalog; it is simply a version of a catalog that has open source renderers available. +This is a pre-defined catalog file that contains a basic set of general-purpose components (Buttons, Inputs, Cards). It is not a special "type" of catalog; it is simply a version of a catalog that has open source renderers available. For the complete component gallery with examples, see [Component Reference](../reference/components.md). diff --git a/docs/ecosystem/a2ui-in-the-world.md b/docs/ecosystem/a2ui-in-the-world.md index a8601ba2b..f860d5da3 100644 --- a/docs/ecosystem/a2ui-in-the-world.md +++ b/docs/ecosystem/a2ui-in-the-world.md @@ -76,7 +76,7 @@ The [Agent Development Kit](https://google.github.io/adk-docs/) (ADK) is Google' **How ADK uses A2UI:** -ADK integrated the A2UI v0.8 standard catalog to automatically render spec-compliant agent parts as native UI components directly in the chat. ADK also handles A2UI↔A2A message conversion, so agents built with ADK can send rich UI to any A2UI-capable client. +ADK integrated the A2UI v0.8 basic catalog to automatically render spec-compliant agent parts as native UI components directly in the chat. ADK also handles A2UI↔A2A message conversion, so agents built with ADK can send rich UI to any A2UI-capable client. - **Built-in rendering**: ADK Web renders A2UI components natively in the dev UI. - **A2A integration**: A2UI messages are converted between A2A DataPart metadata and ADK events. diff --git a/docs/ecosystem/renderers.md b/docs/ecosystem/renderers.md index f6a3f2bd2..6d9877089 100644 --- a/docs/ecosystem/renderers.md +++ b/docs/ecosystem/renderers.md @@ -43,7 +43,7 @@ These projects are not directly A2UI renderers but are closely related and do su **sivamrudram-eng/a2ui-react-native** is the only React Native renderer, enabling A2UI on iOS and Android via a single codebase. -**BBC6BAE9/a2ui-swift** (formerly **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. +**BBC6BAE9/a2ui-swift** (formerly **a2ui-swiftui**) is a native SwiftUI renderer supporting iOS, macOS, visionOS, watchOS, and tvOS. It covers all 18 basic A2UI components with dual v0.8 + v0.9 protocol support, includes JSONL streaming, and uses the Observation framework for reactivity. ## Submitting a Renderer diff --git a/docs/guides/renderer-development.md b/docs/guides/renderer-development.md index 6e703cab0..5e3e7263f 100644 --- a/docs/guides/renderer-development.md +++ b/docs/guides/renderer-development.md @@ -92,7 +92,7 @@ Implement the following rendering logic: - Buffer all incoming `surfaceUpdate` and `dataModelUpdate` messages without rendering immediately. - Handle `beginRendering`: This message acts as the explicit signal to perform the initial render of a surface and set the root component ID. - Start rendering from the specified `root` component ID. - - If a `catalogId` is provided, ensure the corresponding component catalog is used (defaulting to the standard catalog if omitted). + - If a `catalogId` is provided, ensure the corresponding component catalog is used (defaulting to the basic catalog if omitted). - Apply any global `styles` (e.g., `font`, `primaryColor`) provided in this message. - **Data Binding Resolution**: - Implement a resolver for `BoundValue` objects found in component properties. @@ -113,28 +113,28 @@ Implement the following communication features: - Send the complete `userAction` object to the server's event handling endpoint. - **Client Capabilities Reporting**: - In **every** A2A message sent to the server (as part of the metadata), include an `a2uiClientCapabilities` object. - - This object should declare the component catalog your client supports via `supportedCatalogIds` (e.g., including the URI for the standard 0.8 catalog). + - This object should declare the component catalog your client supports via `supportedCatalogIds` (e.g., including the URI for the basic 0.8 catalog). - Optionally, if the server supports it, provide `inlineCatalogs` for custom, on-the-fly component definitions. - **Error Reporting**: Implement a mechanism to send an `error` message to the server to report any client-side errors (e.g., failed data binding, unknown component type). -## II. Standard Component Catalog Checklist +## II. Basic Component Catalog Checklist -To ensure a consistent user experience across platforms, A2UI defines a standard set of components. Your client should map these abstract definitions to their corresponding native UI widgets. +To ensure a consistent user experience across platforms, A2UI defines a basic set of components. Your client should map these abstract definitions to their corresponding native UI widgets. ### Basic Content -The standard catalog includes the following basic content components: +The basic catalog includes the following basic content components: - **Text**: Render text content. Must support data binding on `text` and a `usageHint` for styling (h1-h5, body, caption). - **Image**: Render an image from a URL. Must support `fit` (cover, contain, etc.) and `usageHint` (avatar, hero, etc.) properties. -- **Icon**: Render a predefined icon from the standard set specified in the catalog. +- **Icon**: Render a predefined icon from the basic set specified in the catalog. - **Video**: Render a video player for a given URL. - **AudioPlayer**: Render an audio player for a given URL, optionally with a description. - **Divider**: Render a visual separator, supporting both `horizontal` and `vertical` axes. ### Layout & Containers -The standard catalog includes the following layout and container components: +The basic catalog includes the following layout and container components: - **Row**: Arrange children horizontally. Must support `distribution` (justify-content) and `alignment` (align-items). Children can have a `weight` property to control flex-grow behavior. - **Column**: Arrange children vertically. Must support `distribution` and `alignment`. Children can have a `weight` property to control flex-grow behavior. @@ -145,7 +145,7 @@ The standard catalog includes the following layout and container components: ### Interactive & Input Components -The standard catalog includes the following interactive and input components: +The basic catalog includes the following interactive and input components: - **Button**: A clickable element that triggers a `userAction`. Must be able to contain a `child` component (typically Text or Icon) and may vary in style based on the `primary` boolean. - **CheckBox**: A checkbox that can be toggled, reflecting a boolean value. diff --git a/docs/index.md b/docs/index.md index 4f62102b2..54c468c91 100644 --- a/docs/index.md +++ b/docs/index.md @@ -25,7 +25,7 @@ A2UI enables AI agents to generate rich, interactive user interfaces that render | Version | Status | Description | | -------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **[v0.8](specification/v0.8-a2ui.md)** | **Stable** | Current production release. Surfaces, components, data binding, adjacency list model. | -| **[v0.9](specification/v0.9-a2ui.md)** | **Draft** | Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. [Evolution guide →](specification/v0.9-evolution-guide.md) | +| **[v0.9](specification/v0.9-a2ui.md)** | **Current** | Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. [Evolution guide →](specification/v0.9-evolution-guide.md) | A2UI is Apache 2.0 licensed, created by Google with contributions from CopilotKit and the open source community, diff --git a/docs/introduction/what-is-a2ui.md b/docs/introduction/what-is-a2ui.md index b9cb5953c..f9b1c571f 100644 --- a/docs/introduction/what-is-a2ui.md +++ b/docs/introduction/what-is-a2ui.md @@ -106,7 +106,7 @@ A2UI: JSON messages describing UI that: } ``` -=== "v0.9 (Draft)" +=== "v0.9 (Current)" ```jsonl { diff --git a/docs/reference/components.md b/docs/reference/components.md index 339a04784..dd618cd2c 100644 --- a/docs/reference/components.md +++ b/docs/reference/components.md @@ -205,7 +205,7 @@ Display images from URLs. ### Icon -Display icons from the standard set defined in the catalog. +Display icons from the basic set defined in the catalog. === "v0.8" diff --git a/docs/reference/messages.md b/docs/reference/messages.md index a7ea91b7a..faaf9cd50 100644 --- a/docs/reference/messages.md +++ b/docs/reference/messages.md @@ -49,7 +49,7 @@ Signals the client to initialize and render a surface. | ----------- | ------ | -------- | --------------------------------------------------------------------------------------- | | `surfaceId` | string | ✅ | Unique identifier for this surface. | | `root` | string | ✅ | The `id` of the component that should be the root of the UI tree for this surface. | - | `catalogId` | string | ❌ | Identifier for the component catalog. Defaults to the v0.8 standard catalog if omitted. | + | `catalogId` | string | ❌ | Identifier for the component catalog. Defaults to the v0.8 basic catalog if omitted. | | `styles` | object | ❌ | Styling information for the UI, as defined by the catalog. | ### Example diff --git a/docs/reference/renderers.md b/docs/reference/renderers.md index 99f04d399..c138d3c75 100644 --- a/docs/reference/renderers.md +++ b/docs/reference/renderers.md @@ -16,7 +16,7 @@ You have a lot of flexibility, to bring custom components to a renderer, or buil | Renderer | Platform | v0.8 | v0.9 | Links | | ------------------------ | ------------------ | --------- | --------- | ------------------------------------------------------------------------------------ | -| **React** | Web | ✅ Stable | ❌ | [Code](https://github.com/google/A2UI/tree/main/renderers/react) | +| **React** | Web | ✅ Stable | ✅ Stable | [Code](https://github.com/google/A2UI/tree/main/renderers/react) | | **Lit (Web Components)** | Web | ✅ Stable | ✅ Stable | [Code](https://github.com/google/A2UI/tree/main/renderers/lit) | | **Angular** | Web | ✅ Stable | ✅ Stable | [Code](https://github.com/google/A2UI/tree/main/renderers/angular) | | **Flutter (GenUI SDK)** | Mobile/Desktop/Web | ✅ Stable | ✅ Stable | [Docs](https://docs.flutter.dev/ai/genui) · [Code](https://github.com/flutter/genui) | diff --git a/docs/roadmap.md b/docs/roadmap.md index 9bcd7a023..f00889ca1 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -6,27 +6,22 @@ This roadmap outlines the current state and future plans for the A2UI project. T ### Protocol -| Version | Status | Notes | -| -------- | --------- | --------------------------------------- | -| **v0.8** | ✅ Stable | Initial public release | -| **v0.9** | 🚧 Draft | Prompt-First specification improvements | - -Key features: - -- Streaming JSONL message format. -- Four core message types (`surfaceUpdate`, `dataModelUpdate`, `beginRendering`, `deleteSurface`). -- Adjacency list component model. -- JSON Pointer-based data binding. -- Separation of structure and state. +| Version | Status | Notes | +| -------- | ---------- | --------------------------------------- | +| **v0.8** | 🆗 Prior | Initial public release, minimal support | +| **v0.9** | ✅ Current | Feature complete, supported | +| **v0.10**| 🚧 Draft | Minimal changes to spec, new features | +| **v1.0** | 🚧 Draft | Stable and complete | ### Renderers | Client libraries | Status | Platform | Notes | | ---------------------------------------------------------- | -------------- | -------------- | ------------------------------------------------------------------- | +| **Web Core Lib** | ✅ Stable | Web | Shared core lib for all web renderers | | **Web Components (Lit)** | ✅ Stable | Web | Framework-agnostic, works anywhere | | **Angular** | ✅ Stable | Web | Full Angular integration | | **Flutter (GenUI SDK)** | ✅ Stable | Multi-platform | Works on mobile, web, desktop | -| **React** | 🚧 In Progress | Web | Coming Q1 2026 | +| **React** | ✅ Stable | Web | Official React renderer | | **SwiftUI** | 📋 Planned | iOS/macOS | Planned for Q2 2026 | | **Jetpack Compose** | 📋 Planned | Android | Planned for Q2 2026 | | **Vue** | 💡 Proposed | Web | Community interest | @@ -39,33 +34,25 @@ Key features: | -------------------------------- | ----------- | --------------------------- | | **A2A Protocol** | ✅ Complete | Native A2A transport | | **AG UI** | ✅ Complete | Day-zero compatibility | -| **REST API** | 📋 Planned | Bidirectional communication | -| **WebSockets** | 💡 Proposed | Bidirectional communication | -| **SSE (Server-Sent Events)** | 💡 Proposed | Web streaming | -| **MCP (Model Context Protocol)** | 💡 Proposed | Community interest | - -### Agent UI toolkits - -| Agent UI toolkit | Status | Notes | -| ------------------- | ----------- | -------------------------------------- | -| **CopilotKit** | ✅ Complete | Day-zero compatibility thanks to AG UI | -| **Open AI ChatKit** | 💡 Proposed | Community interest | -| **Vecel AI SDK UI** | 💡 Proposed | Community interest | +| **REST API** | ✅ Complete | Request/response over HTTP | +| **WebSockets** | ✅ Complete | Bidirectional WS | +| **MCP (Model Context Protocol)** | ✅ Complete | Context sharing | ### Agent frameworks -| Integration | Status | Notes | -| ------------------------------ | ----------- | ---------------------------------------------------------------------------------- | -| **Any agent with A2A support** | ✅ Complete | Day-zero compatibility thanks to A2A protocol | -| **ADK** | 📋 Planned | Still designing developer ergonomics, see [samples](../samples/agent/adk) | -| **Genkit** | 💡 Proposed | Community interest | -| **LangGraph** | 💡 Proposed | Community interest | -| **CrewAI** | 💡 Proposed | Community interest | -| **AG2** | ✅ Complete | [A2UIAgent](https://docs.ag2.ai/latest/docs/user-guide/reference-agents/a2uiagent) | -| **Claude Agent SDK** | 💡 Proposed | Community interest | -| **OpenAI Agent SDK** | 💡 Proposed | Community interest | -| **Microsoft Agent Framework** | 💡 Proposed | Community interest | -| **AWS Strands Agent SDK** | 💡 Proposed | Community interest | +| Integration | Status | Notes | +| -------------------------------- | -------------- | ---------------------------------------------------------------------------------- | +| **Any agent with A2A support** | ✅ Complete | Day-zero compatibility thanks to A2A protocol | +| **Any agent with AG-UI support** | ✅ Complete | Day-zero compatibility thanks to AG UI protocol | +| **AG2** | ✅ Complete | [A2UIAgent](https://docs.ag2.ai/latest/docs/user-guide/reference-agents/a2uiagent) | +| **ADK** | 🚧 In Progress | Still designing developer ergonomics, see [samples](../samples/agent/adk) | +| **Genkit** | 💡 Proposed | Community interest | +| **LangGraph** | 💡 Proposed | Community interest | +| **CrewAI** | 💡 Proposed | Community interest | +| **Claude Agent SDK** | 💡 Proposed | Community interest | +| **OpenAI Agent SDK** | 💡 Proposed | Community interest | +| **Microsoft Agent Framework** | 💡 Proposed | Community interest | +| **AWS Strands Agent SDK** | 💡 Proposed | Community interest | ## Recent Milestones @@ -73,7 +60,7 @@ Key features: Many research projects across multiple Google teams, including integration into internal products and agents. -### Q4 2025 +### Q4 2025 v0.8 - v0.8.0 spec released - A2A extension (thanks Google A2A team! teased at [a2asummit.ai](https://a2asummit.ai)) @@ -83,31 +70,24 @@ Many research projects across multiple Google teams, including integration into - AG UI / CopilotKit integration (thanks CopilotKit team!) - Github public release (Apache 2.0) -## Upcoming Milestones - -### Q1 2026 +### Q2 2026 v0.9 -#### A2UI v0.9 - -- Release candidate for spec 0.9 -- Improve theming support for renderers (complete) -- Improve server side theming support for agents (minimal) +- Release spec 0.9 +- Release web core and renderers to support spec 0.9 +- Launch official A2UI React renderer +- Improve theming support for renderers +- Launch A2UI Agents SDK (python) - Improve developer ergonomics -#### React Renderer - -A native React renderer with hooks-based API and full TypeScript support. - -- React support for common widgets -- React support for custom components -- `useA2UI` hook for message handling -- React support for theming +## Upcoming Milestones -### Q2 2026 +### Q3 2026 v0.9 & v0.10 -#### Native Mobile Renderers +**Jetpack Compose Renderer (Android):** -Native renderers for iOS and Android platforms. +- Native Compose UI components +- Material Design 3 support +- Android platform integration **SwiftUI Renderer (iOS/macOS):** @@ -115,24 +95,16 @@ Native renderers for iOS and Android platforms. - iOS design language support - macOS compatibility -**Jetpack Compose Renderer (Android):** - -- Native Compose UI components -- Material Design 3 support -- Android platform integration - -#### Performance Optimizations +**Performance Optimizations** - Renderer performance benchmarks - Lazy loading for large component trees - Virtual scrolling for lists - Component memoization strategies -### Q4 2026 - -#### Protocol v1.0 +### Q4 2026 v1.0 -Finalize v1.0 of the protocol with: +**Finalize v1.0 of the protocol with:** - Stability guarantees - Migration path from v0.9 @@ -141,7 +113,15 @@ Finalize v1.0 of the protocol with: ## Long-Term Vision -### Multi-Agent Coordination +**Full App UIs** + +Configurable, Customizable UIs - facilitated by A2UI (agent optional) + +- Developer tooling for A2UI at build time +- Patterns for A2UI caching, as config layer for static UI +- Designs and samples for full app composition + +**Multi-Agent Coordination** Enhanced support for multiple agents contributing to the same UI: @@ -149,7 +129,7 @@ Enhanced support for multiple agents contributing to the same UI: - Conflict resolution strategies - Shared surface management -### Accessibility Features +**Accessibility Features** First-class accessibility support: @@ -158,7 +138,7 @@ First-class accessibility support: - Keyboard navigation standards - Contrast and color guidance -### Advanced UI Patterns +**Advanced UI Patterns** Support for more complex UI interactions: @@ -167,35 +147,24 @@ Support for more complex UI interactions: - 3D rendering - AR/VR interfaces (exploratory) -### Ecosystem Growth +**Ecosystem Growth** - More framework integrations - Third-party component libraries - Agent marketplace integration - Enterprise features and support -## Community Requests - -Features requested by the community (in no particular order): - -- **More renderer integrations**: Map from your client library to A2UI -- **More agent frameworks**: Map from your agent framework to A2UI -- **More transports**: Map from your transport to A2UI -- **Community component library**: Share custom components with the community -- **Community samples**: Share custom samples with the community -- **Community evaluations**: Generative UI evaluation scenarios and labeled datasets -- **Developer Ergonomics**: If you can build a better A2UI experience, share it with the community - ## How to Influence the Roadmap We welcome community input on priorities: -1. **Vote on Issues**: Give 👍 to GitHub issues you care about -2. **Propose Features**: Open a discussion on GitHub (search for existing discussions first) -3. **Submit PRs**: Build the features you need (search for existing PRs first) -4. **Join Discussions**: Share your use cases and requirements (search for existing discussions first) +1. **Submit feedback form**: Use [this anonymous form](https://forms.gle/Tj8E3dMsJ1NcvQnFA) to share your requirements and feedback +2. **Vote on Issues**: Give 👍 to GitHub issues you care about +3. **Propose Features**: Open a discussion on GitHub (search for existing discussions first) +4. **Submit PRs**: Build the features you need (search for existing PRs first) +5. **Join Discussions**: Share your use cases and requirements (search for existing discussions first) -## Release Cycle +## Planned Release Cycle - **Major versions** (1.0, 2.0): Annual or when significant breaking changes are needed - **Minor versions** (1.1, 1.2): Quarterly with new features @@ -209,14 +178,6 @@ A2UI follows [Semantic Versioning](https://semver.org/): - **MINOR**: Backward-compatible functionality additions - **PATCH**: Backward-compatible bug fixes -## Get Involved - -Want to contribute to the roadmap? - -- **Propose features** in [GitHub Discussions](https://github.com/google/A2UI/discussions) -- **Build prototypes** and share them with the community -- **Join the conversation** on GitHub Issues - ## Stay Updated - Watch the [GitHub repository](https://github.com/google/A2UI) for updates From f84c0957c061c86836d03352252c3e20f4b07d17 Mon Sep 17 00:00:00 2001 From: alan bount Date: Wed, 29 Apr 2026 15:17:35 +0000 Subject: [PATCH 2/3] Docs: Address PR comments by restoring headings and adding @a2ui/markdown-it Restore level 3 headings in roadmap.md as requested by reviewer. Add @a2ui/markdown-it to ecosystem renderers doc. TAG=agy CONV=97210f91-e190-45b1-ac9b-32bb0e86d314 --- docs/ecosystem/renderers.md | 4 ++++ docs/roadmap.md | 10 +++++----- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/ecosystem/renderers.md b/docs/ecosystem/renderers.md index 6d9877089..b9982e7a4 100644 --- a/docs/ecosystem/renderers.md +++ b/docs/ecosystem/renderers.md @@ -35,6 +35,10 @@ These projects are not directly A2UI renderers but are closely related and do su | ---------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **vercel-labs/json-render** (`@json-render/*`) | React, Vue, Svelte, Solid, React Native | Generative UI framework by Vercel — uses its own JSON schema (not A2UI protocol) with Zod-based component catalogs. Supports streaming, 36 pre-built shadcn/ui components, and cross-platform rendering. | [GitHub](https://github.com/vercel-labs/json-render) · [npm](https://www.npmjs.com/package/@json-render/core) · [Docs](https://json-render.dev/) | +### Ecosystem Utilities + +- **[@a2ui/markdown-it](https://www.npmjs.com/package/@a2ui/markdown-it)** — Enables markdown rendering in the Text widgets of all renderers. + ### Highlights **easyops-cn/a2ui-sdk** (`@a2ui-sdk/react`) is the most fully-featured community React renderer, with 11 published versions, Radix UI primitives, Tailwind CSS styling, and a dedicated docs site. It was [announced on the A2UI discussions](https://github.com/google/A2UI/discussions/489). For the official A2UI React renderer, see [`@a2ui/react`](https://www.npmjs.com/package/@a2ui/react). diff --git a/docs/roadmap.md b/docs/roadmap.md index f00889ca1..9b40a7fd0 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -113,7 +113,7 @@ Many research projects across multiple Google teams, including integration into ## Long-Term Vision -**Full App UIs** +### Full App UIs Configurable, Customizable UIs - facilitated by A2UI (agent optional) @@ -121,7 +121,7 @@ Configurable, Customizable UIs - facilitated by A2UI (agent optional) - Patterns for A2UI caching, as config layer for static UI - Designs and samples for full app composition -**Multi-Agent Coordination** +### Multi-Agent Coordination Enhanced support for multiple agents contributing to the same UI: @@ -129,7 +129,7 @@ Enhanced support for multiple agents contributing to the same UI: - Conflict resolution strategies - Shared surface management -**Accessibility Features** +### Accessibility Features First-class accessibility support: @@ -138,7 +138,7 @@ First-class accessibility support: - Keyboard navigation standards - Contrast and color guidance -**Advanced UI Patterns** +### Advanced UI Patterns Support for more complex UI interactions: @@ -147,7 +147,7 @@ Support for more complex UI interactions: - 3D rendering - AR/VR interfaces (exploratory) -**Ecosystem Growth** +### Ecosystem Growth - More framework integrations - Third-party component libraries From e542a5bb933be03df35bea694d626f5b6e7a91ff Mon Sep 17 00:00:00 2001 From: alan bount Date: Fri, 8 May 2026 17:07:22 +0000 Subject: [PATCH 3/3] Docs: Resolve PR comments and apply formatting --- docs/concepts/catalogs.md | 2 +- docs/index.md | 6 ++--- docs/roadmap.md | 50 +++++++++++++++++++-------------------- 3 files changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/concepts/catalogs.md b/docs/concepts/catalogs.md index 814d77267..c214737ee 100644 --- a/docs/concepts/catalogs.md +++ b/docs/concepts/catalogs.md @@ -59,7 +59,7 @@ Whether you are building a simple prototype or a complex production application, To help developers get started quickly, the A2UI team maintains the [Basic Catalog](../../specification/v0_9/json/basic_catalog.json). -This is a pre-defined catalog file that contains a basic set of general-purpose components (Buttons, Inputs, Cards) and functions. It is not a special "type" of catalog; it is simply a version of a catalog that we have already written and have open source renderers for. +This is a pre-defined catalog file that contains a basic set of general-purpose components (Buttons, Inputs, Cards) and functions. It is not a special "type" of catalog; it is simply a version of a catalog that we have already written and have open source renderers for. The basic catalog allows you to bootstrap an application or validate A2UI concepts without needing to write your own schema from scratch. It is intentionally sparse to remain easily implementable by different renderers. diff --git a/docs/index.md b/docs/index.md index 54c468c91..5cbc94b35 100644 --- a/docs/index.md +++ b/docs/index.md @@ -22,9 +22,9 @@ A2UI enables AI agents to generate rich, interactive user interfaces that render ## Specification Versions -| Version | Status | Description | -| -------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **[v0.8](specification/v0.8-a2ui.md)** | **Stable** | Current production release. Surfaces, components, data binding, adjacency list model. | +| Version | Status | Description | +| -------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **[v0.8](specification/v0.8-a2ui.md)** | **Stable** | Current production release. Surfaces, components, data binding, adjacency list model. | | **[v0.9](specification/v0.9-a2ui.md)** | **Current** | Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. [Evolution guide →](specification/v0.9-evolution-guide.md) | A2UI is Apache 2.0 licensed, diff --git a/docs/roadmap.md b/docs/roadmap.md index 9b40a7fd0..dd5080337 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -6,37 +6,37 @@ This roadmap outlines the current state and future plans for the A2UI project. T ### Protocol -| Version | Status | Notes | -| -------- | ---------- | --------------------------------------- | -| **v0.8** | 🆗 Prior | Initial public release, minimal support | -| **v0.9** | ✅ Current | Feature complete, supported | -| **v0.10**| 🚧 Draft | Minimal changes to spec, new features | -| **v1.0** | 🚧 Draft | Stable and complete | +| Version | Status | Notes | +| --------- | ---------- | --------------------------------------- | +| **v0.8** | 🆗 Prior | Initial public release, minimal support | +| **v0.9** | ✅ Current | Feature complete, supported | +| **v0.10** | 🚧 Draft | Minimal changes to spec, new features | +| **v1.0** | 🚧 Draft | Targeting stable and complete release | ### Renderers -| Client libraries | Status | Platform | Notes | -| ---------------------------------------------------------- | -------------- | -------------- | ------------------------------------------------------------------- | -| **Web Core Lib** | ✅ Stable | Web | Shared core lib for all web renderers | -| **Web Components (Lit)** | ✅ Stable | Web | Framework-agnostic, works anywhere | -| **Angular** | ✅ Stable | Web | Full Angular integration | -| **Flutter (GenUI SDK)** | ✅ Stable | Multi-platform | Works on mobile, web, desktop | -| **React** | ✅ Stable | Web | Official React renderer | -| **SwiftUI** | 📋 Planned | iOS/macOS | Planned for Q2 2026 | -| **Jetpack Compose** | 📋 Planned | Android | Planned for Q2 2026 | -| **Vue** | 💡 Proposed | Web | Community interest | -| [**Svelte/Kit**](https://svelte.dev/docs/kit/introduction) | 💡 Proposed | Web | [Community interest](https://news.ycombinator.com/item?id=46287728) | -| **ShadCN (React)** | 💡 Proposed | Web | Community interest | +| Client libraries | Status | Platform | Notes | +| ---------------------------------------------------------- | ----------- | -------------- | ------------------------------------------------------------------- | +| **Web Core Lib** | ✅ Stable | Web | Shared core lib for all web renderers | +| **Web Components (Lit)** | ✅ Stable | Web | Framework-agnostic, works anywhere | +| **Angular** | ✅ Stable | Web | Full Angular integration | +| **Flutter (GenUI SDK)** | ✅ Stable | Multi-platform | Works on mobile, web, desktop | +| **React** | ✅ Stable | Web | Official React renderer | +| **SwiftUI** | 📋 Planned | iOS/macOS | Planned for Q2 2026 | +| **Jetpack Compose** | 📋 Planned | Android | Planned for Q2 2026 | +| **Vue** | 💡 Proposed | Web | Community interest | +| [**Svelte/Kit**](https://svelte.dev/docs/kit/introduction) | 💡 Proposed | Web | [Community interest](https://news.ycombinator.com/item?id=46287728) | +| **ShadCN (React)** | 💡 Proposed | Web | Community interest | ### Transports -| Transport | Status | Notes | -| -------------------------------- | ----------- | --------------------------- | -| **A2A Protocol** | ✅ Complete | Native A2A transport | -| **AG UI** | ✅ Complete | Day-zero compatibility | -| **REST API** | ✅ Complete | Request/response over HTTP | -| **WebSockets** | ✅ Complete | Bidirectional WS | -| **MCP (Model Context Protocol)** | ✅ Complete | Context sharing | +| Transport | Status | Notes | +| -------------------------------- | ----------- | -------------------------- | +| **A2A Protocol** | ✅ Complete | Native A2A transport | +| **AG UI** | ✅ Complete | Day-zero compatibility | +| **REST API** | ✅ Complete | Request/response over HTTP | +| **WebSockets** | ✅ Complete | Bidirectional WS | +| **MCP (Model Context Protocol)** | ✅ Complete | Context sharing | ### Agent frameworks