# nx-ui > nx-ui is the Nexus ReGen shared UI component library: the full shadcn component suite built on Base UI primitives (`@base-ui/react`), restyled to the Untitled UI design language with Nexus ReGen branding. It ships as a shadcn registry — components, AI Elements ports, blocks, domain widgets, reference datasets, themes and lib modules are vendored into consumer repos with the shadcn CLI; nothing imports nx-ui at runtime. A showcase app at ui.nexusregen.com doubles as browsable docs and visual QA. ## Consumption Add an `@nx-ui` entry to the `registries` map in the consumer's `components.json`. Two hosts serve the same registry JSON — the committed `public/r/` output, one file per item: ```json { "registries": { "@nx-ui": { "url": "https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/{name}.json", "headers": { "Authorization": "token ${NX_UI_GITHUB_TOKEN}" } } } } ``` Or, once deployed, the plain Vercel host with no auth header: `https://ui.nexusregen.com/r/{name}.json`. Install any item with the shadcn CLI: ``` bunx shadcn@latest add @nx-ui/ ``` **Install `@nx-ui/theme` first, always.** It ships the Untitled UI design-token foundation (`styles/nx-ui-theme.css`) that every other item's styling assumes, and it is not an implicit dependency of anything else — nothing pulls it in automatically. Brand variants (`@nx-ui/theme-`) layer on top of it afterwards and are opt-in. ## Version & updates Registry digest: `sha256:4c4df05706d3c5712121dfdd873622c5249587fc68620f2f02bbacba9eeace3a` — changes whenever any item's content changes. Per-item content hashes live at [versions.json](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/versions.json) (also at https://ui.nexusregen.com/r/versions.json); record the hashes you installed at in an `nx-ui.lock` via the `@nx-ui/nx-ui-doctor` item and compare later to detect drift. What changed and when is in the [changelog](https://ui.nexusregen.com/changelog) ([machine-readable](https://ui.nexusregen.com/llms-changelog.txt)). Updates are pull-based and explicit: preview with `bunx shadcn@latest add @nx-ui/ --diff`, apply with `--overwrite` (keep vendored files pristine — customise via wrapper components). Agent guidance: [start here](https://ui.nexusregen.com/agents) · consuming skill: `nx-ui:skills/nx-ui-components` · update-loop skill: `nx-ui:skills/nx-ui-maintain` (vendor both into the consuming repo per nx-standards skills rules). ## Components - [accordion](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/accordion.json): A vertically stacked set of interactive headings that each reveal an associated section of content. - [alert](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/alert.json): Displays a short, important message in a way that attracts the user's attention without interrupting their task. - [alert-dialog](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/alert-dialog.json): A modal dialog that interrupts the user with important content and expects a response. - [aspect-ratio](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/aspect-ratio.json): Displays content within a fixed aspect ratio. - [attachment](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/attachment.json): Displays a file or media attachment, typically inside a chat message or composer. - [avatar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/avatar.json): An image element with a fallback for representing a user or entity. - [background-pattern](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/background-pattern.json): The nx-ui Background Pattern component. - [badge](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/badge.json): A small label used to highlight status, category or count. - [banner](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/banner.json): The nx-ui Banner component. - [breadcrumb](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/breadcrumb.json): Displays the path to the current page and lets the user navigate back up the hierarchy. - [bubble](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/bubble.json): A chat message bubble for conversational interfaces. - [button](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/button.json): A clickable control used to trigger an action or event. - [button-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/button-group.json): Groups related buttons together with consistent spacing and shared borders. - [calendar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/calendar.json): A date field component that lets users enter and edit dates via a visual calendar grid. - [card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/card.json): A container that groups related content and actions in a bordered, elevated surface. - [carousel](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/carousel.json): A slideshow-style container for cycling through a set of items. - [chart](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/chart.json): A themed wrapper around Recharts for building consistent data visualisations. - [checkbox](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/checkbox.json): A control that allows the user to toggle between checked, unchecked and indeterminate states. - [checkbox-card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/checkbox-card.json): A selectable card pairing a checkbox with a title and description — bordered, rounded and brand-tinted when checked, in the Untitled UI checkbox-group idiom. - [checkbox-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/checkbox-group.json): Provides shared state to a series of checkboxes, so a set of checkboxes (or checkbox cards) can be driven by one value array. - [collapsible](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/collapsible.json): An interactive panel that can be expanded or collapsed to show or hide content. - [color-picker](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/color-picker.json): A full colour picker with a saturation/hue/alpha area, hex and RGB fields, presets and an eyedropper. - [color-swatch](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/color-swatch.json): A rounded colour chip with a checkerboard alpha backing, selectable standalone or in a radio-style swatch grid. - [combobox](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/combobox.json): An input combining a text field with a filterable list of selectable options. - [command](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/command.json): A fast, composable command palette for search-driven navigation and actions. - [content-divider](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/content-divider.json): The nx-ui Content Divider component. - [context-menu](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/context-menu.json): A menu of actions triggered by a right click or long press, anchored to the pointer. - [css-background-pattern](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/css-background-pattern.json): The nx-ui Css Background Pattern component. - [currency-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/currency-input.json): An amount field with a currency symbol and thousands-separator formatting on blur. - [date-picker](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/date-picker.json): The nx-ui Date Picker component. - [dialog](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/dialog.json): A window overlaid on the page, rendering content that requires user attention or interaction. - [direction](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/direction.json): Provides text-direction (LTR/RTL) context to descendant components. - [drawer](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/drawer.json): A panel that slides in from the edge of the screen, typically used on smaller viewports. - [dropdown-menu](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/dropdown-menu.json): Displays a menu of actions or options triggered by a button. - [editable](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/editable.json): An inline click-to-edit control that swaps preview text for an input in place, for renaming titles, labels and notes. - [empty](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/empty.json): A placeholder layout for empty, zero-data or not-yet-populated states. - [field](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/field.json): A layout primitive for composing form fields with labels, descriptions and validation messages. - [file-upload](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/file-upload.json): The nx-ui File Upload component. - [glow](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/glow.json): The nx-ui Glow component. - [hover-card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/hover-card.json): Displays rich content in a preview card when a user hovers over a trigger element. - [input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/input.json): A control for entering and editing a single line of text. - [input-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/input-group.json): Combines an input with adjoining buttons, icons or add-ons into a single control. - [input-otp](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/input-otp.json): An input for entering one-time passcodes, split across individual character slots. - [item](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/item.json): A generic list-row layout primitive for building consistent list and menu items. - [kbd](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/kbd.json): Displays a keyboard shortcut or key combination. - [label](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/label.json): An accessible label associated with a form control. - [loading-overlay](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/loading-overlay.json): The nx-ui Loading Overlay component. - [marker](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/marker.json): A small positional indicator, typically used to flag status on another element. - [menubar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/menubar.json): A horizontal menu bar with drop-down menus, similar to a desktop application menu. - [message](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/message.json): Renders a single message within a conversational or chat layout. - [message-scroller](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/message-scroller.json): Manages scroll position and visibility for a scrolling list of chat messages. - [native-select](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/native-select.json): A styled wrapper around the native HTML select element. - [navigation-menu](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/navigation-menu.json): A collection of links and menus for site or application navigation. - [notification](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/notification.json): The persistent inbox row: unread edge bar and tint, leading avatar or severity tile with an optional type-badge overlay, two-line title and preview, right-hand time column, inline decision row and a hover-revealed quick-action pill. - [number-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/number-input.json): A numeric field with increment and decrement steppers, built on Base UI's number field. - [pagination](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/pagination.json): Controls for navigating between pages of paginated content. - [phone-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/phone-input.json): A country-code select paired with a formatted national number field, exposing the full E.164 value. - [popover](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/popover.json): Displays rich content in a portal, anchored to a trigger element. - [progress](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/progress.json): Displays an indicator showing the completion progress of a task. - [progress-circle](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/progress-circle.json): The nx-ui Progress Circle component. - [quantity-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/quantity-input.json): A number input paired with a unit select, for entering material quantities with conversion between units. - [radio-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/radio-group.json): A set of mutually exclusive, checkable radio buttons. - [rating](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/rating.json): The nx-ui Rating component. - [resizable](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/resizable.json): A set of resizable panels split by a draggable handle. - [scroll-area](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/scroll-area.json): A custom scrollable area with consistently styled scrollbars across platforms. - [section-divider](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/section-divider.json): The nx-ui Section Divider component. - [select](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/select.json): Displays a list of options for the user to pick from, triggered by a button. - [separator](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/separator.json): Visually or semantically separates content. - [sheet](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/sheet.json): A panel that slides in from the edge of the screen, extending the dialog primitive. - [sidebar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/sidebar.json): A composable, themeable application sidebar with collapsible sections. - [skeleton](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/skeleton.json): A placeholder used to indicate content that is currently loading. - [slider](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/slider.json): An input for selecting a numeric value, or range of values, from within a range. - [sonner](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/sonner.json): Untitled UI-styled notification toasts via the Sonner library, plus a progress-toast helper. - [spinner](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/spinner.json): A loading indicator for asynchronous operations. - [stepper](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/stepper.json): The nx-ui Stepper component. - [switch](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/switch.json): A control for toggling between checked and unchecked states. - [table](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/table.json): A set of components for displaying tabular data. - [tabs](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/tabs.json): A set of layered sections of content, shown one panel at a time. - [tag](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/tag.json): The nx-ui Tag component. - [tags-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/tags-input.json): The nx-ui Tags Input component. - [textarea](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/textarea.json): A control for entering and editing multi-line text. - [timeline](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/timeline.json): The nx-ui Timeline component. - [toggle](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/toggle.json): A two-state button that can be toggled on or off. - [toggle-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/toggle-group.json): A set of two-state buttons that can be toggled on or off, individually or as a group. - [tooltip](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/tooltip.json): A popup that displays informative text when a user hovers or focuses an element. - [tree](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/tree.json): A hierarchical view of expandable, selectable rows for project scopes, folder structures and nested taxonomies. ## AI Elements - [ai-artifact](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-artifact.json): A side-panel wrapper for a generated artifact, with title, actions and close control. - [ai-canvas](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-canvas.json): A React Flow board wrapper for agent-workflow canvases, with pan, zoom and background. - [ai-chain-of-thought](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-chain-of-thought.json): A collapsible step-by-step chain-of-thought trace with search results and images. - [ai-checkpoint](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-checkpoint.json): A restore-checkpoint divider shown between conversation turns. - [ai-code-block](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-code-block.json): A Shiki-highlighted code block with light and dark rendering and a copy button. - [ai-confirmation](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-confirmation.json): A human-in-the-loop approve or reject card for a pending tool call. - [ai-connection](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-connection.json): The in-progress connection line drawn while wiring two workflow nodes. - [ai-context](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-context.json): A token-usage and context-window meter with a hover breakdown of input, output and cost. - [ai-controls](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-controls.json): The zoom and fit controls for a workflow canvas. - [ai-conversation](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-conversation.json): A scroll container that sticks to the bottom while streaming, with a scroll-to-bottom control. - [ai-edge](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-edge.json): A custom animated edge renderer for the workflow canvas. - [ai-image](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-image.json): Renders an AI-generated image from a base64 or URL file part. - [ai-inline-citation](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-inline-citation.json): Inline citation badges with a hover-card carousel of source cards and quotes. - [ai-loader](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-loader.json): An animated multi-dot loading indicator for pending AI responses. - [ai-message](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-message.json): A chat message row with assistant markdown, action toolbar, branches and attachments. - [ai-model-selector](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-model-selector.json): A command-palette model picker with provider logos and keyboard shortcuts. - [ai-node](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-node.json): A styled workflow node card with header, content, footer, actions and handles. - [ai-open-in-chat](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-open-in-chat.json): A dropdown that deep-links the current prompt into external chat apps. - [ai-panel](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-panel.json): A floating overlay panel anchored to the workflow canvas. - [ai-plan](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-plan.json): A collapsible multi-step plan card with per-step status and actions. - [ai-prompt-input](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-prompt-input.json): A full chat composer: auto-growing textarea, model select, tools, attachments and speech input. - [ai-queue](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-queue.json): A sectioned, collapsible list of queued user turns with attachments and todos. - [ai-reasoning](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-reasoning.json): A collapsible reasoning panel that auto-opens while thinking and tracks duration. - [ai-shimmer](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-shimmer.json): A text shimmer sweep, used for pending or thinking states. - [ai-sources](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-sources.json): A collapsible list of cited sources shown beneath an answer. - [ai-task](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-task.json): A collapsible task and subtask list with file chips for agent activity. - [ai-tool](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-tool.json): Renders a single tool invocation with header, collapsible input and output. - [ai-toolbar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-toolbar.json): A node toolbar of context actions for a workflow node. - [ai-types](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-types.json): Dependency-free type shims mirroring the AI SDK types the AI Elements components reference. - [ai-use-controllable-state](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-use-controllable-state.json): A local controllable-state hook used by the AI Elements collapsible components. - [ai-web-preview](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-web-preview.json): An embedded iframe live preview with a URL bar, navigation and console panel. ## Blocks - [activity-feed](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/activity-feed.json): The nx-ui Activity Feed block. - [ai-chat](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ai-chat.json): A complete chat surface — conversation, streamed messages, reasoning, tools, sources, suggestions and composer — composed from the AI primitives with mocked local streaming. - [app-breadcrumbs](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/app-breadcrumbs.json): Breadcrumb navigation styled for the nx app shell. - [app-shell](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/app-shell.json): The nx application shell: fixed sidebar, main content card and page chrome, with an optional top bar carrying scope breadcrumbs and actions above the page card. - [app-sidebar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/app-sidebar.json): The nx-ui App Sidebar block. - [app-switcher](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/app-switcher.json): The sidebar-header launcher for the Nexus app family: a grid popover of product tiles (NxAppIcon tones) with the active app marked and coming-soon entries disabled. - [auth-login](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/auth-login.json): The sign-in surface — a LoginForm card (email, password, remember me, forgot-password link, social sign-in, sign-up prompt) plus split-screen and centred-card page layouts. - [auth-recovery](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/auth-recovery.json): The account-recovery flow as composable cards — forgotten-password request, check-your-email confirmation, new-password reset and an OTP verification step — sharing one idiom with a back-to-login link. - [auth-signup](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/auth-signup.json): The account-creation surface — name/email/password with a live strength meter and requirements checklist, terms acceptance, social sign-up and a sign-in prompt. - [avatar-group](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/avatar-group.json): The nx-ui Avatar Group block. - [backdrop](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/backdrop.json): The config-driven decorative section backdrop: glow, texture (grid/dots/diagonal/crosshair/contours/topo), grain and a blueprint frame, with named presets and dark-aware ink. - [background-patterns](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/background-patterns.json): A set of stock Untitled-UI CSS masked-grid backdrops (basic, fading and diagonal-cross variants) for a one-liner decorative layer. - [boundary-map](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/boundary-map.json): A site-boundary map rendering polygon parcels with a brand fill, outline and hover state. - [calendar-view](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/calendar-view.json): A props-driven event calendar with month, week, day and agenda views — capped event chips with an overflow popover, overlap-aware hour-gridded time columns, all-day and multi-day spanning bars, a live current-time line and optional pointer drag-to-move. - [cta-banner](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/cta-banner.json): The full-bleed navy call-to-action band, with split or centred layout and the accent CTA hover nudge. - [data-table](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/data-table.json): A TanStack Table kit in the shadcn data-table idiom, styled to the Untitled UI look: sorting, faceted and multi-column filters, global search, row selection with a bulk-action bar, pagination, column visibility, pinning, expandable sub-rows, loading skeletons and an empty state. - [device-mockup](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/device-mockup.json): The nx-ui Device Mockup block. - [empty-state](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/empty-state.json): A full empty-state layout combining a featured icon, message and call to action. - [error-page](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/error-page.json): Full-page error and status surfaces — 404, 500, maintenance and access-denied variants with a display-scale code, featured icon, copy, up to two CTAs, an optional backdrop and a search slot. - [faq](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/faq.json): A grouped FAQ composed on the nx-ui Accordion, styled as rounded cards that ring on open. - [feature-card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/feature-card.json): The flexible marketing card — default, dashed-outline and self-flipping on-brand variants, with an optional hover-lift link affordance. - [feature-row](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/feature-row.json): An alternating image/copy feature row with an optional icon, eyebrow and checklist. - [featured-icon](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/featured-icon.json): The Untitled-UI-style icon-in-a-decorative-container, used atop empty states and alerts. - [filter-bar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/filter-bar.json): The nx-ui Filter Bar block. - [grid-backdrop](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/grid-backdrop.json): A lightweight standalone grid backdrop for brand bands, testimonials and stat cards — navy on light, accent-yellow on dark. - [hero-split](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/hero-split.json): The two-column landing hero — headline and CTAs beside a media slot — with the CSS-only animated accent underline. - [how-it-works](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/how-it-works.json): A numbered process with an animated gradient dashed connector, in horizontal or vertical orientation. - [isochrone-tool](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/isochrone-tool.json): Travel-time isochrone overlays for map-view: a settings popover (profile, max time, interval), navy-to-blue contour fills, a legend info bar and point-in-polygon reach filtering, fetched via the nx-geo isochrone contract. - [kanban](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/kanban.json): A generic kanban board styled to the Untitled UI look: colour-coded columns with count badges, WIP-limit indication and overflow-menu slots, slot-based cards carrying badges, assignee avatars and due dates, and pointer drag-and-drop with a floating ghost and live drop indicator — fully keyboard-operable with aria-live announcements. - [listing-card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/listing-card.json): The shared listing presentation: a standalone card and the map popup with the select-for-exchange call to action, drawing one body — operator, place, status/category badges, gate-fee range and lazily fetched waste types and EWC codes — plus the badge atoms the panel rows reuse. - [listings-filters](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/listings-filters.json): The left-hand search & filter panel: injected place search with recents, free-text listing search, toned type chips, a category tree with indeterminate group states, region checklist, operational-only switch and gate-fee range — every control with live faceted counts, plus an active-filter chip row. - [listings-panel](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/listings-panel.json): The right-hand Opportunities overlay: a virtualised, keyboard-navigable listings list with a live in-view count header, sort menu, tone-ringed selection and bidirectional hover/select sync with the map; collapses to an edge tab on desktop and a bottom sheet on mobile. - [logo-cloud](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/logo-cloud.json): A social-proof logo band as a CSS marquee (auto-scroll, reduced-motion aware) or a static grid. - [map-marker](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/map-marker.json): A branded pin marker with a selected state and a rounded popup card for map annotations. - [map-stat-overlay](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/map-stat-overlay.json): A floating glass stat and legend panel that sits over a map. - [map-toolbar](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/map-toolbar.json): The glass-pill map control toolbar: a prop-driven standard arrangement (zoom, locate, Map/Satellite switcher, tool toggles, reset view) or fully composable groups, buttons and toggles. - [map-view](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/map-view.json): A theme-aware Mapbox map wrapper with UUI-styled zoom and basemap-style controls. - [marketplace-map](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/marketplace-map.json): The orchestrating marketplace map surface: supercluster bubbles with type-mix rings, toned facility pins with hover/selected states, an HTML spiderfy fan, travel-time and route tool integration, search-this-area re-querying, listing popups with the exchange handoff, and the full transfer-preview choreography. - [marketplace-types](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/marketplace-types.json): The marketplace family's shared contract: the nx-geo listings wire shapes (GeoJSON FeatureCollection + faceted meta), the flat client listing record, filter/sort state, facility-type tones, the material category tree and formatting helpers. - [media-player](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/media-player.json): A styled media player shell — a poster with a centred featured-icon play overlay, a native video wrapped in a UUI-styled control bar (scrubber, time, volume, fullscreen), and a MediaThumbnail sibling that opens the film in a dialog. - [metric-card](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/metric-card.json): The nx-ui Metric Card block. - [motion](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/motion.json): The scroll-reveal motion utilities — FadeIn, Stagger and StaggerItem plus the shared EASE constant. - [notification-centre](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/notification-centre.json): A bell trigger with an unread badge opening a 420px popover inbox: All/Unread/Archived tabs, rows date-grouped under sticky blurred headers, a scroll fade, hover quick actions, inline invite decisions, mark-all-read and per-tab empty states. Exports NotificationRow for standalone feeds. - [nx-app-icon](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/nx-app-icon.json): The Google-style Nexus product app-icon family: the arrow emblem on a rounded tile, tinted by fixed brand tones — a set of identity artefacts that stay constant across light/dark and brand variants. - [nx-emblem](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/nx-emblem.json): The Nexus ReGen arrow logomark as an inline SVG with a weight scale (regular keyline through solid) and currentColor fills, for crisp, legible marks at any size. - [nx-logo](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/nx-logo.json): The Nexus ReGen logotype (emblem, lockup and wordmark), drawn inline as vector paths and coloured by token so it flips correctly with the theme. - [onboarding-checklist](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/onboarding-checklist.json): A setup-progress card — overall progress bar, ordered step rows with done/current/locked states, a collapsible completed group, a dismiss control and a compact variant for docking in a sidebar. - [org-switcher](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/org-switcher.json): A control for switching between organisations within the app shell. - [page-header](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/page-header.json): A consistent page header with title, description and actions. - [page-hero](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/page-hero.json): The reusable interior/marketing hero with tone (default/brand) and align (left/center) variants, over a decorative backdrop. - [pricing-table](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/pricing-table.json): Marketing pricing surface — tier cards with a highlighted popular plan, a monthly/annual billing toggle that swaps per-period prices, and a features-by-plans comparison-table variant with tick/dash cells. - [route-map](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/route-map.json): A movement route map with origin and destination markers and a brand line with a dashed progress overlay. - [route-tool](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/route-tool.json): Click-to-add waypoint routing for map-view: numbered draggable role-coloured pins, the accent-yellow route line and a floating distance/duration info bar, with a debounced fetch against the nx-geo routing contract. - [scope](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/scope.json): The org ▸ project scope contract shared by the scoped-shell blocks: OrgRef/ProjectRef display snapshots, the Scope type and the onOrgChange/onProjectChange/onProjectClear callback vocabulary. - [scope-breadcrumbs](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/scope-breadcrumbs.json): The top-bar context switcher: an organisation crumb with a workspace menu, a project crumb with a project switcher and an All-projects escape (shown only when scoped), then ordinary path crumbs. - [scoped-nav](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/scoped-nav.json): The two-level sliding sidebar navigation: workspace-level nav and per-project nav with a Back-to-all-projects row, sliding between levels as a project enters or leaves scope. - [scroll-fade](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/scroll-fade.json): A scroll container with top/bottom token-gradient fades that appear while more content exists in that direction, plus an optional click-to-scroll 'more below' indicator pill — built for long sidebar navs and list panels. - [section](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/section.json): The marketing layout backbone: Section (toned, padded band) plus Eyebrow and SectionHeading. - [settings](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/settings.json): The settings-page kit: a responsive shell with sticky side tabs on desktop and a native select on mobile, a two-column label/control section idiom, and reference sections for profile, notifications, team management and destructive actions. - [sidebar-nav](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/sidebar-nav.json): The nx-ui Sidebar Nav block. - [site-footer](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/site-footer.json): The navy marketing footer with a watermark, hairline divider, link columns and an optional theme toggle. - [site-header](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/site-header.json): The marketing header — a sticky glassy bar with desktop mega-menus and a mobile popover menu, all props-driven. - [site-map](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/site-map.json): A clustered site map: point markers that group into brand-coloured cluster bubbles you can click to expand. - [stats-band](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/stats-band.json): The accent-on-navy metric treatment in three idioms: stat cards, a stat-plus-quote proof band, and an on-image overlay. - [testimonials](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/testimonials.json): Customer testimonials on a dark brand band — a motion crossfade carousel or a static grid. - [theme-toggle](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-toggle.json): A control for switching between light, dark and system colour themes. - [transfer-preview](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/transfer-preview.json): The marketplace transfer-proposal flow: 70° cinematic camera choreography over a route, pulsing endpoint pins, and a bottom dock with source/destination cards, animated truck stats, a volume slider and a save-proposal callback. - [use-listings-clusters](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/use-listings-clusters.json): Client-side clustering for the marketplace map: a headless supercluster hook whose clusters carry per-tone leaf breakdowns (for type-mix rings), plus expansion-zoom and leaves helpers for zoom-to-split and spiderfy. - [use-marketplace](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/use-marketplace.json): The headless marketplace orchestrator hook: one owner for the server query (debounced, aborting, stale-while-revalidate), the committed query bbox behind search-this-area, the live viewport, reach filtering, the derived visible set, hover/selection sync, the select-for-exchange pair and the camera. - [user-menu](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/user-menu.json): An account menu with organisation switching, theme toggle and sign-out, shown in the app shell. ## Domain - [chain-of-custody](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/chain-of-custody.json): A waste-transfer audit trail built on the Timeline primitive — typed custody events (produced through disputed) with per-type tones, verification states, transfer-note document chips, quantity deltas and licensed party cards, in compact and detailed variants. - [compliance-checklist](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/compliance-checklist.json): A generic pass/fail/warn/na readiness checklist card, modelled on Digital Waste Tracking compliance. - [ewc-selector](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/ewc-selector.json): The European Waste Catalogue picker: a hybrid segmented code entry and search-by-description dropdown, plus a full List of Wastes lookup modal (chapter navigation, WM3 mirror/hazard classification, evidence previews) behind an inline lookup field. - [location-selector](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/location-selector.json): A UK location picker: address search plus an optional draggable map pin (Mapbox), and the movement-form flow — a selected-location card field backed by a config-driven picker modal with directory search and a map/address escape hatch. - [material-selector](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/material-selector.json): Construction-material pickers: a compact search combobox, a card-driven class → term drill-down wizard, and a status-gated field with a grouped picker modal that cascades EWC, unit and hazard suggestions. - [opportunities](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/opportunities.json): The opportunity matrix family: every routing pathway considered for a material requirement — multi-step routes, itemised cost estimates, compatibility scores and AI viability assessments — presented visually first (a proximity map, a cost-proportional flow canvas and a cost-vs-readiness decision grid) with comparable cards, a baseline-anchored comparison, a full transparency matrix and a composable detail record behind. - [permit-badge](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/permit-badge.json): Carrier and permit credential atoms: a status-tinted PermitBadge pill with registration number and expiry countdown, a fuller PermitCard with holder, dates and a verify-on-register link slot, and an inline VerificationTick. - [project-scope-selector](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/project-scope-selector.json): Construction project-scope selection in several layouts — card-grid wizard, hierarchical checklist tree, grouped multi-select combobox and a segmented category/items panel. - [transfer-note](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/transfer-note.json): A sectioned UK waste transfer note form — parties, waste description with an EWC selector slot, SIC code, quantity and container, transfer details, broker/dealer and signed declarations — plus a read-only TransferNoteSummary card for review states. ## Data - [data-ewc-codes](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/data-ewc-codes.json): The full European Waste Catalogue (List of Waste, 2014/955/EU) flattened to a single array — every chapter, subcategory and leaf code, with material category, hazardous and construction-relevant flags. - [data-geo-fixtures](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/data-geo-fixtures.json): Deterministic geo fixtures for the mock nx-geo API routes — synthetic route and isochrone generators used when Mapbox is unreachable (or SMOKE is set), keeping map demos deterministic offline. - [data-material-terms](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/data-material-terms.json): A construction & earthworks material taxonomy — classes (soil, aggregate, concrete, asphalt, waste…) and their leaf terms, with synonyms and reference densities. - [data-project-scopes](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/data-project-scopes.json): A realistic construction project-scope dataset — work categories, phases/packages and their activities, for scope-selection UIs. ## Themes - [theme](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme.json): The Nexus ReGen design-token foundation: the full Untitled UI colour, type, shadow and radius system, mapped onto shadcn's semantic CSS variables. - [theme-ember](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-ember.json): Ember brand theme — a warm, energetic orange brand-ramp override. - [theme-evergreen](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-evergreen.json): Evergreen brand theme — a deep regenerative forest green with the Nexus accent retained. - [theme-graphite](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-graphite.json): Graphite brand theme — a restrained near-monochrome graphite brand-ramp override. - [theme-nexus-midnight](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-nexus-midnight.json): Nexus colours with faintly navy light surfaces and an immersive brand-navy dark mode. - [theme-nexus-sand](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-nexus-sand.json): Nexus colours on warm stone surfaces — a paper-like light UI and a warm charcoal dark mode. - [theme-nexus-slate](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-nexus-slate.json): Nexus colours on cool, blue-slate surfaces — a subtly tinted light UI and a deep blue-slate dark mode. - [theme-ocean](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-ocean.json): Ocean brand theme — a clear, confident blue brand-ramp override. - [theme-ultraviolet](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/theme-ultraviolet.json): Ultraviolet brand theme — the Untitled UI signature purple, as a drop-in brand-ramp override. ## Lib - [flare-styles](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/flare-styles.json): Keyframes for nx-ui's design-flare decorations (the marquee animation used by avatar-group and empty-state). Import after the theme. - [geo-api](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/geo-api.json): Mock nx-geo API route handlers — POST /api/geo/route and POST /api/geo/isochrone proxy Mapbox in the nx-geo envelope and response shapes, falling back to deterministic fixtures when offline. - [mapbox](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/mapbox.json): Mapbox configuration — the public token (env-overridable) and the light/dark/satellite style URLs used by the map-based blocks. - [mapbox-overrides](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/mapbox-overrides.json): CSS overrides for mapbox-gl's injected chrome — hides the Mapbox logo and attribution control on every map. Imported directly by the map blocks; ships automatically with map-view and location-selector. - [nx-ui-doctor](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/nx-ui-doctor.json): Drift detection for vendored nx-ui items: `lock` records installed items' registry hashes in nx-ui.lock, `check` compares them against /r/versions.json, `wrap-audit` flags local edits. Run with `bun lib/nx-ui-doctor.ts `. - [os-grid-reference](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/os-grid-reference.json): WGS84 latitude/longitude to Ordnance Survey (British National Grid) grid-reference conversion, self-contained (no dependencies). - [use-mobile](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/use-mobile.json): The nx-ui use-mobile() hook. - [utils](https://raw.githubusercontent.com/nexus-regen/nx-ui/main/public/r/utils.json): The cn() class-merging utility, built on clsx and a display-scale-aware tailwind-merge. ## Recent changes Latest 10 of 46 entries — full history at [llms-changelog.txt](https://ui.nexusregen.com/llms-changelog.txt). - 2026-07-07 added [nx-ui-doctor]: Version management and agent ops landed: every registry item now has a published content hash in `/r/versions.json` (compare against your `nx-ui.lock` to detect drift), this changelog (one entry per PR, browsable at `/changelog`, machine-readable at `/llms-changelog.txt`), the `@nx-ui/nx-ui-doctor` script for consumer-side `lock`/`check`/`wrap-audit`, an agent onboarding page at `/agents`, CI, and scheduled maintenance loops. - 2026-07-07 docs (#35): The docs engine: view-code toggles on every demo, generated API/props tables, cross-link chips between related items, per-item markdown cards at `/llms/.md`, a table-of-contents rail and dual-mode preview canvases. - 2026-07-07 fixed: Accessibility wave: all 111 serious findings from the a11y audit cleared across the component suite and showcase — missing accessible names and labels, aria reference integrity, duplicate ids, landmarks and contrast. - 2026-07-06 internal (#34): Showcase wayfinding: collapsible nav groups, command-palette upgrades (including recents), a top bar dogfooding ScopeBreadcrumbs, a keyboard-shortcuts dialog, and the first changelog page. - 2026-07-06 fixed (#30): Bare `text-tertiary`/`text-quaternary` utilities (which don't exist in the theme) replaced with the correct full-token forms `text-text-tertiary`/`text-text-quaternary` wherever they had crept in. - 2026-07-06 changed (#23) [sonner]: Toasts restyled to Untitled UI and extended to the full sonner capability suite, including the progress-toast helper. - 2026-07-06 docs (#12): Consumer skill bumped to 1.2.0: theme-variant wiring, block install paths and refreshed inventories. - 2026-07-06 added (#27) [scroll-fade, user-menu, breadcrumb]: Sidebar-nav scroll affordances via the new `scroll-fade` block, a user-menu organisation section, and breadcrumb Untitled UI parity. - 2026-07-06 fixed (#18) [theme]: Restored the shadcn custom variants and utilities the theme had dropped — `styles/shadcn-compat.css` now ships with the theme item, carrying the `data-*` variants and scroll/shimmer utilities the base-vega components rely on. - 2026-07-06 added (#19) [app-shell, scope, scope-breadcrumbs, scoped-nav, app-switcher]: The scoped app shell for core nx products: optional top bar, org ▸ project scope breadcrumbs with switchers, the two-level sliding sidebar nav, and the app-switcher launcher. `app-shell` gained the top-bar slot (additive).