{"id":49868472,"url":"https://github.com/victorcodess/nexus-ui","last_synced_at":"2026-05-15T04:06:39.806Z","repository":{"id":344804462,"uuid":"1162755458","full_name":"victorcodess/nexus-ui","owner":"victorcodess","description":"Beautiful, customizable components for modern AI experiences.","archived":false,"fork":false,"pushed_at":"2026-05-11T11:01:30.000Z","size":1254,"stargazers_count":65,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T12:38:36.416Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://nexus-ui.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/victorcodess.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-20T16:50:48.000Z","updated_at":"2026-05-11T11:01:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/victorcodess/nexus-ui","commit_stats":null,"previous_names":["victorcodess/nexus-ui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/victorcodess/nexus-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorcodess%2Fnexus-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorcodess%2Fnexus-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorcodess%2Fnexus-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorcodess%2Fnexus-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victorcodess","download_url":"https://codeload.github.com/victorcodess/nexus-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorcodess%2Fnexus-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33053173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-15T02:00:06.351Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-15T04:06:37.344Z","updated_at":"2026-05-15T04:06:39.792Z","avatar_url":"https://github.com/victorcodess.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"2400\" height=\"1260\" alt=\"image\" src=\"https://github.com/user-attachments/assets/d70ca019-c9fb-4f37-94b3-a9f238a4c7e7\" /\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eNexus UI\u003c/h1\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Beautiful, customizable components for modern AI experiences.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nexus-ui.dev\"\u003eDocumentation\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/prompt-input\"\u003ePrompt Input\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/model-selector\"\u003eModel Selector\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/suggestions\"\u003eSuggestions\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/attachments\"\u003eAttachments\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/message\"\u003eMessage\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/thread\"\u003eThread\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/citation\"\u003eCitation\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/reasoning\"\u003eReasoning\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/text-shimmer\"\u003eText Shimmer\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/image\"\u003eImage\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/feedback-bar\"\u003eFeedback Bar\u003c/a\u003e ·\n  \u003ca href=\"https://nexus-ui.dev/docs/components/toaster\"\u003eToaster\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## About\n\nNexus UI is a design-first component library for building AI-powered applications. It provides a set of composable primitives that integrate seamlessly with the [Vercel AI SDK](https://sdk.vercel.ai), [ElevenLabs](https://elevenlabs.io), and other AI services.\n\nThink of it as **shadcn/ui, but purpose-built for AI apps**.\n\nInstead of adapting general-purpose components for AI use cases, Nexus UI is designed from the ground up for streaming, voice, multimodal, and agentic interfaces.\n\nCopy-paste components into your project. You own the code.\n\n## Components\n\n| Component       | Description                                                                 |\n| --------------- | --------------------------------------------------------------------------- |\n| `PromptInput`   | Composable chat input with auto-resizing textarea and action slots          |\n| `ModelSelector` | Dropdown for selecting AI models with radio groups, sub-menus, and items    |\n| `Suggestions`   | Prompt suggestion chips for guiding user input                               |\n| `Attachments`   | File-attachment UI for inputs and messages (compact, inline, detailed, pasted) |\n| `Message`       | Chat message layout with markdown body, optional avatar, actions, and attachments |\n| `Thread`        | Chat thread viewport with stick-to-bottom scrolling and scroll-to-bottom control |\n| `Citation`      | Inline citations with hover preview, favicons, and multi-source carousel    |\n| `Reasoning`     | Collapsible reasoning trace with streaming labels and markdown content        |\n| `TextShimmer`   | Animated shimmer text for loading and in-progress states                    |\n| `Image`         | AI image UI for URLs, base64, and bytes with preview, loader, lightbox, and actions |\n| `FeedbackBar`   | Feedback prompt bar with composable info, actions, tooltips, and close section |\n| `Toaster`       | Headless toast notifications powered by Sonner, with variant-aware styling and custom action/cancel controls |\n\n## Quick Start\n\nMake sure you have [shadcn/ui](https://ui.shadcn.com) initialized in your project:\n\n```bash\nnpx shadcn@latest init\n```\n\nAdd components using any of these methods:\n\n**Option 1: shadcn CLI (recommended)**\n\nNexus UI is in the [shadcn registry](https://ui.shadcn.com/registry). No config needed:\n\n```bash\nnpx shadcn@latest add @nexus-ui/prompt-input\nnpx shadcn@latest add @nexus-ui/model-selector\nnpx shadcn@latest add @nexus-ui/suggestions\nnpx shadcn@latest add @nexus-ui/attachments\nnpx shadcn@latest add @nexus-ui/message\nnpx shadcn@latest add @nexus-ui/thread\nnpx shadcn@latest add @nexus-ui/citation\nnpx shadcn@latest add @nexus-ui/reasoning\nnpx shadcn@latest add @nexus-ui/text-shimmer\nnpx shadcn@latest add @nexus-ui/image\nnpx shadcn@latest add @nexus-ui/feedback-bar\nnpx shadcn@latest add @nexus-ui/toaster\n```\n\n**Option 2: Direct URL**\n\n```bash\nnpx shadcn@latest add https://nexus-ui.dev/r/prompt-input.json\n```\n\n**Option 3: Nexus UI CLI**\n\n```bash\nnpx nexus-ui-cli@latest\n# or add specific components\nnpx nexus-ui-cli@latest add prompt-input model-selector suggestions attachments message thread citation reasoning text-shimmer image feedback-bar toaster\n```\n\nTo use the `@nexus-ui` scope with a custom registry, add to your `components.json`:\n\n```json\n{\n  \"registries\": {\n    \"@nexus-ui\": \"https://nexus-ui.dev/r/{name}.json\"\n  }\n}\n```\n\n## Usage\n\n```tsx\nimport { Button } from \"@/components/ui/button\";\nimport {\n  PromptInput,\n  PromptInputActions,\n  PromptInputAction,\n  PromptInputActionGroup,\n  PromptInputTextarea,\n} from \"@/components/nexus-ui/prompt-input\";\nimport { ArrowUp02Icon, PlusSignIcon } from \"@hugeicons/core-free-icons\";\nimport { HugeiconsIcon } from \"@hugeicons/react\";\n\nconst ChatInput = () =\u003e {\n  return (\n    \u003cPromptInput\u003e\n      \u003cPromptInputTextarea /\u003e\n      \u003cPromptInputActions\u003e\n        \u003cPromptInputActionGroup\u003e\n          \u003cPromptInputAction asChild\u003e\n            \u003cButton className=\"size-8 cursor-pointer gap-1 rounded-full border-none bg-transparent text-[13px] leading-6 font-normal text-gray-900 hover:bg-gray-200 dark:text-white dark:hover:bg-gray-700\"\u003e\n              \u003cHugeiconsIcon icon={PlusSignIcon} strokeWidth={2.0} className=\"size-4\" /\u003e\n            \u003c/Button\u003e\n          \u003c/PromptInputAction\u003e\n        \u003c/PromptInputActionGroup\u003e\n\n        \u003cPromptInputActionGroup\u003e\n          \u003cPromptInputAction asChild\u003e\n            \u003cButton className=\"size-8 cursor-pointer gap-1 rounded-full bg-gray-700 text-[13px] leading-6 font-normal text-white hover:bg-gray-200 dark:text-white dark:hover:bg-gray-700\"\u003e\n              \u003cHugeiconsIcon icon={ArrowUp02Icon} strokeWidth={2.0} className=\"size-4\" /\u003e\n            \u003c/Button\u003e\n          \u003c/PromptInputAction\u003e\n        \u003c/PromptInputActionGroup\u003e\n      \u003c/PromptInputActions\u003e\n    \u003c/PromptInput\u003e\n  );\n};\n```\n\n## Tech Stack\n\n- React 19\n- TypeScript\n- Tailwind CSS v4\n- Radix UI Primitives\n- Next.js\n- Fumadocs\n\n## Development\n\n```bash\nnpm install\nnpm run dev\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorcodess%2Fnexus-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorcodess%2Fnexus-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorcodess%2Fnexus-ui/lists"}