---
name: "@nexus-ui"
slug: "nexus-ui"
description: "Open-source copy-paste component library purpose-built for AI interfaces, designed as shadcn/ui for AI apps. Provides 14 composable primitives: PromptInput, ModelSelector, Suggestions, Attachments, Message, Thread, Citation, Reasoning, TextShimmer, Image, FeedbackBar, Toaster, ChainOfThought, and Tool. Built for streaming, voice, multimodal, and agentic UIs; integrates with Vercel AI SDK and ElevenLabs. React 19 + Next.js App Router, TypeScript, Radix primitives, Tailwind CSS. Fully free and MIT-licensed. Use for: building chat interfaces, AI copilots, or agent dashboards that need streaming-aware, accessible chat primitives."
category: "AI/chat UI"
tags: ["accessibility", "ai", "audio", "cards", "dashboard", "design-system", "forms", "hooks", "loaders", "media", "overlays", "text-effects"]
framework: "react"
license: "MIT"
author: "victorcodess"
website: "https://nexus-ui.dev"
github: "https://github.com/victorcodess/nexus-ui"
registry: "https://nexus-ui.dev/r/registry.json"
pro: false
pro_url: null
github_stars: 112
component_count: 15
generated_at: "2026-07-28T08:59:05.895Z"
---

# @nexus-ui

Open-source copy-paste component library purpose-built for AI interfaces, designed as shadcn/ui for AI apps. Provides 14 composable primitives: PromptInput, ModelSelector, Suggestions, Attachments, Message, Thread, Citation, Reasoning, TextShimmer, Image, FeedbackBar, Toaster, ChainOfThought, and Tool. Built for streaming, voice, multimodal, and agentic UIs; integrates with Vercel AI SDK and ElevenLabs. React 19 + Next.js App Router, TypeScript, Radix primitives, Tailwind CSS. Fully free and MIT-licensed. Use for: building chat interfaces, AI copilots, or agent dashboards that need streaming-aware, accessible chat primitives.

## Links

- Website: https://nexus-ui.dev
- GitHub: https://github.com/victorcodess/nexus-ui
- Registry JSON: https://nexus-ui.dev/r/registry.json
- Directory page: https://sh4dcn.vercel.app/registry/nexus-ui
- This file: https://sh4dcn.vercel.app/md/nexus-ui.md

## Install

```sh
# add the whole registry (shadcn CLI)
npx shadcn@latest add https://nexus-ui.dev/r/registry.json
pnpm dlx shadcn@latest add https://nexus-ui.dev/r/registry.json
bunx shadcn@latest add https://nexus-ui.dev/r/registry.json
# clone the source repo
git clone https://github.com/victorcodess/nexus-ui.git
# fetch the raw registry index
curl -s https://nexus-ui.dev/r/registry.json
```

## Components (15)

| name | type | description | install |
| --- | --- | --- | --- |
| prompt-input | registry:ui | Composable chat input with auto-resizing textarea and action slots | `npx shadcn@latest add https://nexus-ui.dev/r/prompt-input.json` |
| suggestions | registry:ui | Prompt suggestion chips for guiding user input | `npx shadcn@latest add https://nexus-ui.dev/r/suggestions.json` |
| attachments | registry:ui | Composable file attachments for chat inputs and messages with preview, variants, and upload wiring | `npx shadcn@latest add https://nexus-ui.dev/r/attachments.json` |
| model-selector | registry:ui | Dropdown for selecting AI models with radio groups, sub-menus, and custom items | `npx shadcn@latest add https://nexus-ui.dev/r/model-selector.json` |
| message | registry:ui | Chat message layout with markdown, optional avatar, actions, and attachments | `npx shadcn@latest add https://nexus-ui.dev/r/message.json` |
| thread | registry:ui | Scrollable chat thread with stick-to-bottom scrolling and jump-to-bottom control | `npx shadcn@latest add https://nexus-ui.dev/r/thread.json` |
| citation | registry:ui | Inline source references with hover preview and multi-source carousel | `npx shadcn@latest add https://nexus-ui.dev/r/citation.json` |
| image | registry:ui | Image renderer for URLs, base64, and byte payloads with preview, loader, lightbox, and action slots | `npx shadcn@latest add https://nexus-ui.dev/r/image.json` |
| reasoning | registry:ui | Collapsible model reasoning trace with streaming-aware labels and markdown body | `npx shadcn@latest add https://nexus-ui.dev/r/reasoning.json` |
| feedback-bar | registry:ui | Feedback prompt bar for per-message or thread ratings with action and close slots | `npx shadcn@latest add https://nexus-ui.dev/r/feedback-bar.json` |
| text-shimmer | registry:ui | Animated shimmer text for loading, tool runs, and other in-progress UI | `npx shadcn@latest add https://nexus-ui.dev/r/text-shimmer.json` |
| toaster | registry:ui | Headless toast notifications powered by Sonner, with variant-aware styling and custom action/cancel controls | `npx shadcn@latest add https://nexus-ui.dev/r/toaster.json` |
| chain-of-thought | registry:ui | Structured multi-step thought timeline with step status, optional expandable output, and auto-close when steps finish | `npx shadcn@latest add https://nexus-ui.dev/r/chain-of-thought.json` |
| tool | registry:ui | Tool call component with state-aware header and JSON input/output blocks | `npx shadcn@latest add https://nexus-ui.dev/r/tool.json` |
| questions | registry:ui | Follow-up clarification questions with single or multiple choice, carousel navigation, and batch submission | `npx shadcn@latest add https://nexus-ui.dev/r/questions.json` |

## For AI agents

```text
You are adding components from @nexus-ui to a shadcn-compatible project.
1. Read this file (https://sh4dcn.vercel.app/md/nexus-ui.md) for the component list.
2. Fetch the machine-readable index: https://nexus-ui.dev/r/registry.json
3. Install a single component with its install command from the table above.
4. Full structured record: https://sh4dcn.vercel.app/json (library slug: nexus-ui).
```