# Generative UI API Reference
URL: /docs/api-reference/generative-ui

Spec-driven generative UI for assistant-ui. The data format an assistant streams, the component registry that resolves it, and the renderer that turns it into React elements.

> For AI agents: a documentation index is available at [llms.txt](/llms.txt). Use `.md` for canonical markdown pages; `.mdx` is kept as a backwards-compatible alias on supported URL paths.

## Pages

- [JSONGenerativeUI](/docs/api-reference/generative-ui/json-generative-ui) — Create present and prompt\_user tools from a generative UI component library, with options for display mode and action dispatch.
- [Generative UI Components](/docs/api-reference/generative-ui/components) — Define the component library JSONGenerativeUI can render, including schemas, render functions, and the default vocabulary.
- [Generative UI Actions](/docs/api-reference/generative-ui/actions) — Register handlers for model-emitted $action payloads and dispatch them from interactive generative UI components.
- [Generative UI Spec](/docs/api-reference/generative-ui/spec) — The serializable node tree an assistant emits to describe generative UI. Covers the GenerativeUISpec format, its nodes, and the message part that carries the spec.
- [Generative UI Rendering](/docs/api-reference/generative-ui/rendering) — Render generative UI trees, build present-tool schemas, and inspect or serialize model-produced UI nodes.
- [Generative UI Tokens](/docs/api-reference/generative-ui/tokens) — Shared token arrays used by the default generative UI vocabulary for sizing, color, alignment, and component variants.