A2UI is an open protocol that lets AI agents generate rich, interactive user interfaces through a declarative JSON format — not executable code. An agent describes what to render; the renderer decides how using native platform controls.
A2UI-Swift is a Swift-based renderer for A2UI that supports all Apple UI frameworks. The SwiftUI implementation is feature-complete, while UIKit and AppKit support are currently under active development. Listed on the official A2UI ecosystem page.
Agent → JSON payload → A2UISurfaceView / A2UIRendererView → Native UI
Add this package to your project via Swift Package Manager:
In Package.swift:
dependencies: [
.package(url: "https://github.com/BBC6BAE9/a2ui-swift", from: "0.1.0"),
],The package is organized into six independent library products:
| Module | Purpose |
|---|---|
| Primitives | Shared primitive types — ChatMessage, Part, JSONValue, ToolDefinition, etc. |
| A2UISwiftCore | v0.9 shared protocol layer — schema, data model, catalog system, expression parser, transport |
| A2UISwiftUI | v0.9 SwiftUI renderer via A2UISurfaceView with SurfaceViewModel |
| A2UIUIKit | v0.9 UIKit renderer — iOS, tvOS, visionOS (community extension point via A2UIUIKitComponent) |
| A2UIAppKit | v0.9 AppKit renderer — macOS (community extension point via A2UIAppKitComponent) |
A2UIRendererView with SurfaceManager |
import A2UISwiftUI
@State var vm = SurfaceViewModel(catalog: basicCatalog)
// Process messages from your agent transport:
try vm.processMessages(messages)
// Render:
A2UISurfaceView(viewModel: vm)
// With action handler:
A2UISurfaceView(viewModel: vm) { action in
print("Action: \(action.name)")
}The original demo app for the v0.8 renderer. Open samples/sample_0.8/A2UIDemoApp.xcodeproj in Xcode.
Includes static JSON demos (no agent required) and live A2A agent connections. Each page has an info inspector explaining what it demonstrates; action-triggering pages display a Resolved Action log showing the full context payload.
| info | action log | genui |
|---|---|---|
 |
 |
 |
Live agent demo is included in the app — no external dependency required.
A full-featured travel app sample demonstrating the v0.9 renderer with AI client integration, custom catalog components, and real generative AI interactions.
The A2A protocol client has been extracted into its own package — a2a-swift — and is consumed here as a remote Swift Package Manager dependency.
swift test