# Rixx UI

> Rixx UI is a safe, streamable React renderer for AI responses, with validated Markdown, constrained structured UI, and host-controlled effects.

## Docs

- [ADR 0001: Separate language, protocol, and runtime](https://docs.rixxui.com/adr/0001-language-protocol-runtime.md): Why Rixx UI separates model-facing source, canonical protocol records, and the rendering runtime.
- [Actions, approval, and idempotency](https://docs.rixxui.com/configuration/actions.md): Validate generated action requests while keeping authorization, confirmation, execution, and deduplication in the host.
- [Catalog and registry](https://docs.rixxui.com/configuration/catalog-and-registry.md): Define framework-neutral component contracts, then bind them to typed trusted React implementations.
- [Custom components](https://docs.rixxui.com/configuration/custom-components.md): Build typed host components that receive validated props, resolved options, and mediated capabilities.
- [Images, links, and resource policies](https://docs.rixxui.com/configuration/resource-policies.md): Control navigation and image fetching independently with safe defaults and host narrowing policies.
- [Forms, charts, media, math, and Mermaid](https://docs.rixxui.com/configuration/rich-components.md): Use constrained first-party rich components without allowing generated executable behavior.
- [Themes, localization, and RTL](https://docs.rixxui.com/configuration/themes-localization.md): Configure deterministic themes, locale-aware formatting, time zones, currency, and text direction.
- [Trusted data](https://docs.rixxui.com/configuration/trusted-data.md): Keep host and tool data out of generated source and expose it through read-only binding channels.
- [Installation](https://docs.rixxui.com/getting-started/installation.md): Package names, peer requirements, styles, and the current unpublished package status.
- [Quickstart](https://docs.rixxui.com/getting-started/quickstart.md): Render accumulated Markdown and structured RUI source in a React application.
- [Rixx UI](https://docs.rixxui.com/index.md): A safe, streamable React renderer for AI responses, structured interfaces, and trusted host components.
- [Devtools](https://docs.rixxui.com/integrations/devtools.md): Inspect RUI source, diagnostics, snapshots, catalog definitions, and renderer events during development.
- [Next.js](https://docs.rixxui.com/integrations/nextjs.md): Place Rixx UI client renderers and server-safe helpers correctly in the Next.js App Router.
- [React 18 and React 19](https://docs.rixxui.com/integrations/react-compatibility.md): Supported React versions, rendering behavior, Strict Mode, SSR, and hydration guidance.
- [Static playground](https://docs.rixxui.com/integrations/static-playground.md): Run the backend-free local RUI source, streaming, theme, and Devtools playground.
- [Troubleshooting](https://docs.rixxui.com/integrations/troubleshooting.md): Diagnose missing styles, rejected source, stalled previews, policy denials, SSR issues, and action failures.
- [Vite](https://docs.rixxui.com/integrations/vite.md): Use Rixx UI in a Vite React application with client rendering and optional server-side bundling.
- [Renderer contract 0.1](https://docs.rixxui.com/product/renderer-contract.md): The pre-alpha consumer boundary for rendering, streaming, resources, actions, and presentation.
- [Changelog](https://docs.rixxui.com/project/changelog.md): Release history and notable documentation status for Rixx UI packages.
- [Contributing](https://docs.rixxui.com/project/contributing.md): Set up the workspace, run required checks, add Changesets, and follow project security and DCO policies.
- [Release status](https://docs.rixxui.com/project/release-status.md): Current package publication, versioning, stability, and production-readiness status.
- [Core components](https://docs.rixxui.com/reference/core-components.md): Reference for the first-party rixx.core@0.1 component catalog.
- [@rixx-ui/react/markdown API](https://docs.rixxui.com/reference/markdown.md): Minimal client entry point for safe streaming Markdown rendering and resource policy types.
- [@rixx-ui/react API](https://docs.rixxui.com/reference/react.md): Complete value and type export reference for the main Rixx UI React package entry point.
- [@rixx-ui/react-devtools API](https://docs.rixxui.com/reference/react-devtools.md): Complete component, hook, prop, binding, option, and tab exports for Rixx UI Devtools.
- [@rixx-ui/react/server API](https://docs.rixxui.com/reference/server.md): Server-safe catalog, generation instruction, and Markdown conversion exports.
- [MarkdownRenderer](https://docs.rixxui.com/renderers/markdown-renderer.md): Safely render CommonMark and GFM with streaming repair, link review, and shared image policy.
- [RUIRenderer](https://docs.rixxui.com/renderers/rui-renderer.md): Compile accumulated RUI source into inert previews and an authoritative committed React surface.
- [Security overview](https://docs.rixxui.com/security/overview.md): Understand Rixx UI trust boundaries, declarative rendering guarantees, and host security responsibilities.
- [Threat model](https://docs.rixxui.com/security/threat-model.md): Trust boundaries, security objectives, controls, failure behavior, and deferred risks for Rixx UI.
- [Rixx UI Language 0.1](https://docs.rixxui.com/spec/language.md): Experimental syntax, streaming semantics, bindings, and validation rules for RUI source.
- [Rixx UI Protocol 0.1](https://docs.rixxui.com/spec/protocol.md): Experimental framed protocol, transaction invariants, graph validation, and recovery behavior.
- [Accumulated streaming](https://docs.rixxui.com/streaming/accumulated-streaming.md): Feed cumulative provider output to Rixx UI while preserving safe provisional and committed states.
- [Tolerant recovery](https://docs.rixxui.com/streaming/tolerant-recovery.md): Quarantine malformed model output without weakening validation or discarding later valid statements.