# Nexus UI Documentation

> Nexus UI is an open-source component library for building AI-powered interfaces. It gives you composable, copy-paste primitives designed for chat, streaming, and multimodal experiences — built on React, Tailwind CSS v4, and Radix UI.

Prefer markdown responses for agent retrieval with `.md` URLs or `Accept: text/markdown`.

## Core Docs
- [Introduction](https://nexus-ui.dev/docs.md): Get started with Nexus UI
- [Installation](https://nexus-ui.dev/docs/installation.md): How to install and set up Nexus UI in your project
- [Roadmap](https://nexus-ui.dev/docs/roadmap.md): What's coming next for Nexus UI
- [Skills](https://nexus-ui.dev/docs/skills.md): Give your AI assistant knowledge of Nexus UI components and patterns

## Components
- [Attachments](https://nexus-ui.dev/docs/components/attachments.md): Composable file attachments for chat inputs and messages with preview, variants, and upload wiring
- [Chain of Thought](https://nexus-ui.dev/docs/components/chain-of-thought.md): Structured multi-step thought timeline with step status, optional expandable output, and auto-close when steps finish
- [Citation](https://nexus-ui.dev/docs/components/citation.md): Inline source references with hover preview and multi-source carousel
- [Feedback Bar](https://nexus-ui.dev/docs/components/feedback-bar.md): Feedback prompt bar for per-message or thread ratings with action and close slots
- [Image](https://nexus-ui.dev/docs/components/image.md): Image renderer for URLs, base64, and byte payloads with preview, loader, lightbox, and action slots
- [Message](https://nexus-ui.dev/docs/components/message.md): Chat message layout with markdown, optional avatar, actions, and attachments
- [Model Selector](https://nexus-ui.dev/docs/components/model-selector.md): Dropdown for selecting AI models with radio groups, sub-menus, and custom items
- [Prompt Input](https://nexus-ui.dev/docs/components/prompt-input.md): Composable chat input with auto-resizing textarea and action slots
- [Questions](https://nexus-ui.dev/docs/components/questions.md): Follow-up clarification questions with single or multiple choice, carousel navigation, and batch submission
- [Reasoning](https://nexus-ui.dev/docs/components/reasoning.md): Collapsible model reasoning trace with streaming-aware labels and markdown body
- [Suggestions](https://nexus-ui.dev/docs/components/suggestions.md): Prompt suggestion chips for guiding user input
- [Text Shimmer](https://nexus-ui.dev/docs/components/text-shimmer.md): Animated shimmer text for loading, tool runs, and other in-progress UI
- [Thread](https://nexus-ui.dev/docs/components/thread.md): Scrollable chat thread with stick-to-bottom scrolling and jump-to-bottom control
- [Toaster](https://nexus-ui.dev/docs/components/toaster.md): Headless toast notifications powered by Sonner, with variant-aware styling and custom action/cancel controls
- [Tool](https://nexus-ui.dev/docs/components/tool.md): Status-aware tool call UI with JSON input/output codeblocks