a2ui-project / a2ui-project/a2ui

[Renderer] React Native Implementation

未关闭
#428 3 条评论 2 个 reaction 已指派 1 人 已被 @ataibarkai 认领 在 GitHub 查看
component: react renderer P2 type: feature/enhancement
主要语言
TypeScript
星标
16.4k
派生
1.3k
平均合并
2 天 13 小时
30 天内合并 PR
134

描述

## Summary

I'm building a React Native renderer for A2UI, following the [Renderer Implementation Guide](https://a2ui.org/guides/renderer-development/).

React Native support is listed on the roadmap but doesn't have an implementation yet. This renderer will enable A2UI-compliant agents to generate native mobile UIs on iOS and Android.

## Repository

https://github.com/sivamrudram-eng/a2ui-react-native

## Current Status (MVP)

### Implemented Features

- **JSONL Stream Parser** - Real-time parsing of A2UI streaming responses
- **Message Dispatcher** - Routes `beginRendering`, `surfaceUpdate`, `dataModelUpdate`, `deleteSurface` messages
- **Surface Registry** - Manages multiple rendering surfaces with component buffers
- **Data Binding** - Full `BoundValue` resolution (literal and path-based)
- **Main Renderer Component** - `A2UIRenderer` that renders the component tree

### MVP Components (8 of 16)

| Component | Status | React Native Mapping |
|-----------|--------|---------------------|
| Text | ✅ | `` |
| Button | ✅ | `` |
| Image | ✅ | `` |
| Row | ✅ | `` |
| Column | ✅ | `` |
| Card | ✅ | `` with shadow |
| List | ✅ | `` |
| TextField | ✅ | `` |

### Planned Components

- Modal, Tabs, Slider
- DateTimeInput, Checkbox, MultipleChoice
- Video, AudioPlayer, Icon, Divider

## Usage Example

```tsx
import { A2UIRenderer } from 'a2ui-react-native';

const App = () => {
const spec = {
surfaceId: 'main',
rootId: 'root',
components: [
{ id: 'root', type: 'Column', children: ['text1', 'btn1'] },
{ id: 'text1', type: 'Text', content: 'Hello A2UI!' },
{ id: 'btn1', type: 'Button', label: 'Click me', action: 'doSomething' },
],
};

return ;
};

Roadmap

- Complete MVP testing with example app
- Add remaining standard components
- Publish to npm
- Add streaming hook (useA2UIStream)
- Submit PR to add to official renderers list

Questions for Maintainers

1. Are there any specific requirements for official renderer inclusion?
2. Should I follow the same directory structure as the Lit/Angular renderers?
3. Any feedback on the implementation approach?

I'd welcome any feedback or guidance. Happy to collaborate with the team on this!

---

Would you like me to help you with anything else after posting the issue, such as:
1. Installing dependencies and testing the build
2. Creating an example Expo app
3. Adding the streaming hook (`useA2UIStream`)

贡献指南

打开贡献指南

调研方向

The issue describes a substantial new renderer implementation. Start by reviewing the existing repository at https://github.com/sivamrudram-eng/a2ui-react-native to see the current MVP status and component mappings. Examine the Renderer Implementation Guide linked in the issue for architectural requirements. The work involves completing the remaining planned components, testing, and preparing for an official PR.

由索引模型根据 Issue 内容生成。

评估

技术栈
nodejs, react-native, typescript
领域
frontend, mobile
Issue 类型
功能
难度
5/5
预计耗时
一周以上
活跃度
冷清
描述清晰度
描述清楚
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。