Skip to content

Latest commit

 

History

226 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReUI | Design-forward shadcn/ui platform with MCP fluency for agents.

License: MIT GitHub Stars TypeScript React Tailwind CSS

Go beyond AI defaults and streamline high-end shadcn projects faster without touching the essentials. 1,105 free components and composed examples built with realistic dashboard layouts.

Explore the component catalog · Component Docs · ReUI Pro · GitHub


About ReUI

ReUI is a free, open-source component library for the shadcn/ui ecosystem. Explore 1,105 production-ready components across 74 categories, each shown inside realistic dashboard layouts (not isolated demos), and copy them directly into your React projects.

Why ReUI?

  • 22 In-House component primitives not in default shadcn/ui - Data Grid, Event Calendar, Gantt, Kanban, Filters, Cascader, Code Block, Sortable, Timeline, Stepper, Tree, and more, built for real-world dashboard requirements
  • 1,105 registry components - Reusable examples composed from shadcn/ui primitives into real-world product flows
  • Dual Component library support - Radix UI and Base UI versions for all 22 in-house components
  • Compatible with Shadcn Create styles and settings - Vega, Nova, Maia, Lyra & Mira.

Key Features

  • 1,105 free examples - Production-ready, copy-paste layouts for dashboards, forms, tables, and more
  • 22 In-house Components - Custom in-house components not found in base shadcn/ui
  • Copy-and-Own Model - No npm package, no lock-in. Own the source code in your repo
  • Dual API - Radix UI and Base UI versions for all in-house components
  • Shadcn Compatible - Built on shadcn primitives and Tailwind CSS
  • All Shadcn Create Themes - Works with New York, Default, and all color token customizations
  • TypeScript - Fully typed components and registry blocks
  • MIT License - Free and open-source forever

Custom In-House Components

ReUI provides in total: 22 custom in-house components not found in base shadcn/ui.

In-House Components (22)

Custom-built, shadcn-compatible components not available in base shadcn/ui. Each is maintained by the Keenthemes team, ships full component API documentation, props reference, and usage examples, and is available in both Radix UI and Base UI flavors at reui.io/docs.

Component # Description Preview Radix UI Docs Base UI Docs
Alert 20 Contextual notifications with severity variants and dismissible states Preview Radix UI Base UI
Autocomplete 12 Searchable input with async filtering and keyboard navigation Preview Radix UI Base UI
Badge 25 Status indicators with multiple styles, sizes, and dot variants Preview Radix UI Base UI
Cascader 20 Nested multi-level combobox with drill-down, columns and tree modes, breadcrumbs, search, async levels and custom rows Preview Radix UI Base UI
Code Block 27 Shiki-highlighted code block for docs, diff review, AI chat and streaming agent output Preview Radix UI Base UI
Data Grid 34 Advanced table powered by TanStack Table + Virtual with DnD, pinning, resizing, and infinite scroll Preview Radix UI Base UI
Date Selector 4 Flexible date range picker with calendar UI and preset ranges Preview Radix UI Base UI
Event Calendar 5 Headless-first calendar with month, week, day, N-day, and agenda views, drag-and-drop scheduling, recurring events, time zones, and an external CRUD contract Preview Radix UI Base UI
Filters 12 Stepped filter builder with nested attributes, popover value editors and a boolean query tree, in chip or advanced chrome Preview Radix UI Base UI
Frame 19 Card-like wrapper for panels and content areas Preview Radix UI Base UI
Gantt 7 Headless-first gantt with split tree and timeline panes, day-to-year scales, zoom, drag and resize scheduling, progress, summary rollups, and an external CRUD contract Preview Radix UI Base UI
Icon Stack 6 Layered isometric icon illustrations for empty states and feature visuals Preview Radix UI Base UI
Icon Tile 17 Icon tile for list row media, feature cards, empty states and dashboard tiles Preview Radix UI Base UI
Kanban 6 Drag-and-drop task boards built on DnD Kit with dynamic overlays and composable cards Preview Radix UI Base UI
Number Field 6 Numeric input with increment/decrement controls and formatting Preview Radix UI Base UI
Phone Input 8 International phone number input with country selector and formatting Preview Radix UI Base UI
Rating 9 Star and icon-based rating with half-star, read-only, and custom icon support Preview Radix UI Base UI
Scrollspy 2 Auto-highlighting navigation that tracks scroll position across sections Preview Radix UI Base UI
Sortable 8 Drag-and-drop list reordering with DnD Kit: vertical, grid, and nested layouts Preview Radix UI Base UI
Stepper 15 Multi-step forms and onboarding wizards with React Hook Form per-step validation Preview Radix UI Base UI
Timeline 12 Vertical and horizontal event timelines with rich content and status markers Preview Radix UI Base UI
Tree 7 Hierarchical data display built on Headless Tree with expand/collapse and keyboard navigation Preview Radix UI Base UI

Shadcn components with example library (52)

All standard shadcn/ui primitives are included with many composed examples:

Component Examples Use case Link
Accordion 11 FAQ layouts, settings panels, and help sections Accordion examples
Alert Dialog 14 Delete confirmations, destructive actions, and critical decisions Alert Dialog examples
Aspect Ratio 8 Responsive media, image galleries, and video previews Aspect Ratio examples
Avatar 35 User profiles, team directories, and comment threads Avatar examples
Breadcrumb 15 Navigation trails, docs hierarchy, and app wayfinding Breadcrumb examples
Button 61 Primary actions, form submissions, and toolbar controls Button examples
Button Group 57 Segmented controls, toolbar actions, and view switchers Button Group examples
Calendar 30 Date picking, scheduling flows, and booking interfaces Calendar examples
Card 18 Content previews, dashboard widgets, and product summaries Card examples
Carousel 11 Image galleries, feature showcases, and testimonials Carousel examples
Chart 25 Analytics dashboards, KPI tracking, and reports Chart examples
Checkbox 22 Multi-select forms, settings preferences, and table selection Checkbox examples
Collapsible 10 Expandable sections, detail rows, and progressive disclosure Collapsible examples
Combobox 28 Searchable selection, async lookup, and command menus Combobox examples
Command 8 Command palettes, global search, and power-user navigation Command examples
Context Menu 10 Right-click menus, file actions, and table row actions Context Menu examples
Dialog 10 Modal forms, focused tasks, and confirmations Dialog examples
Drawer 5 Mobile panels, slide-over forms, and secondary workflows Drawer examples
Dropdown Menu 18 Action menus, profile menus, and toolbar menus Dropdown Menu examples
Empty 20 Zero-data screens, first-run onboarding, and guided next steps Empty examples
Field 11 Form composition, validated inputs, and helper text Field examples
File Upload 10 Drag-and-drop uploads, multi-file flows, and upload progress File Upload examples
Hover Card 8 Profile previews, rich link previews, and contextual details Hover Card examples
Input 31 Form entry, search fields, and auth screens Input examples
Input Group 40 Prefixed inputs, suffixed actions, and combined form controls Input Group examples
Input Otp 6 Verification codes, 2FA flows, and secure confirmation screens Input Otp examples
Item 12 List rows, settings items, and action rows Item examples
Kbd 6 Hotkey hints, command docs, and shortcut legends Kbd examples
Label 13 Form labels, accessible inputs, and field pairing Label examples
Menubar 5 Desktop navigation, editor menus, and app commands Menubar examples
Native Select 6 Lightweight selects, mobile-friendly forms, and basic option picking Native Select examples
Navigation Menu 4 Site navigation, mega menus, and product navigation Navigation Menu examples
Pagination 15 Table pagination, search results, and content archives Pagination examples
Popover 11 Inline settings, contextual actions, and lightweight overlays Popover examples
Progress 8 Upload progress, goal tracking, and setup steps Progress examples
Radio Group 17 Single-choice forms, plan selection, and settings preferences Radio Group examples
Resizable 10 Split panes, workspace layouts, and draggable dividers Resizable examples
Scroll Area 5 Custom scroll regions, sidebar panes, and dense lists Scroll Area examples
Select 33 Form selection, settings menus, and filter controls Select examples
Separator 6 Content grouping, toolbar dividers, and section breaks Separator examples
Sheet 4 Slide-over details, side panels, and task flows Sheet examples
Skeleton 10 Loading placeholders, perceived performance, and content previews Skeleton examples
Slider 12 Range filters, pricing controls, and media settings Slider examples
Sonner 21 Success feedback, error states, and non-blocking updates Sonner examples
Spinner 12 Loading indicators, async actions, and button states Spinner examples
Switch 14 Settings toggles, preferences, and binary choices Switch examples
Table 17 Admin tables, data display, and responsive lists Table examples
Tabs 9 Segmented content, settings views, and dashboard sections Tabs examples
Textarea 6 Comments, long-form input, and support tickets Textarea examples
Toggle 14 Formatting controls, compact actions, and binary UI states Toggle examples
Toggle Group 16 View switches, toolbar options, and mutually exclusive actions Toggle Group examples
Tooltip 16 Inline hints, contextual guidance, and helper text Tooltip examples

Getting Started

Installation

ReUI follows the shadcn CLI approach - add blocks from the registry directly into your project (registry items use the c- prefix):

npx shadcn@latest add @reui/c-button-10
npx shadcn@latest add @reui/c-data-grid-9
npx shadcn@latest add @reui/c-filters-5

Quick Start

  1. Browse the catalog - Visit reui.io/components to explore 1,105 composed examples (c-* blocks)
  2. Copy code - Each example includes a ready-to-use code snippet
  3. Customize - Modify with your Tailwind CSS tokens and design system
  4. Own it - The code lives in your repo, not a package

ReUI builds on @tanstack/react-table, @dnd-kit/core, recharts, react-hook-form, and Headless Tree where it helps, and on plain React everywhere else.

Requirements

  • React 18+
  • Tailwind CSS 3+

Documentation

Each component page includes live examples, copy-paste snippets, CLI installation guides, TypeScript types, prop documentation, and accessibility notes.


ReUI Pro

ReUI's MCP Server and Agent Skill are free for everyone - they make any AI coding agent genuinely good at building with ReUI. A one-time license then unlocks the premium catalog on the same shadcn/ui foundation, with lifetime source ownership - Pro for the blocks, Ultimate for the blocks plus the motion icons and the templates.

Feature Access Description Live preview & docs
543 Pro Blocks Pro Full-page sections across Application, Data Grid, Solutions, eCommerce, Marketing, and AI & Agents, including Event Calendar, Gantt, and Kanban board layouts Blocks · Application · Data Grid · Solutions · eCommerce · Marketing · AI & Agents
638 Motion Icons Ultimate Hand-crafted icons in 4 styles (Outline, Solid, Duotone, Filled) with hover animation, 2,552 variants Icons catalog
MCP Server Free Connect any coding agent (Claude, Codex, Cursor, v0, Lovable, Replit, OpenCode, VS Code, Zed) to the ReUI registry for live search, real component APIs and one-command installs MCP guide
Agent Skill Free One command teaches your agent the ReUI workflow - search, install, read the real API, adapt by reuse Agent skills
Workspace Pro ReUI account with favorites, collections, and team access Sign in

Set up the AI tooling - MCP Server & Agent Skill

One-time license, own the source forever - Compare plans


Community & Support


Local Development

Run this repo locally to browse the catalog, edit examples, or contribute. Requires Node.js 18+ and pnpm.

pnpm install
pnpm dev          # http://localhost:3000

Scripts

Script Description
pnpm dev Start the dev server (uses the already-built preview bundles)
pnpm dev:packages Dev server plus a watcher that rebuilds preview bundles on source change - use when editing example (c-*) or in-house primitive source
pnpm build Production build (regenerates the full registry first, automatically)
pnpm start Serve the production build
pnpm lint / pnpm typecheck Lint / type-check the project

Registry build tasks

The catalog is generated from registry-reui/ source by tools in scripts/. dev, dev:packages, and build wire these up for you - run them manually only when needed.

Task Produces / does Run it when
pnpm components:build Component metadata (categories, counts, search) under registry-reui/_meta/ Auto on postinstall and before dev - rarely by hand
pnpm components:packages The pre-built preview bundles (packages/registry/bases/**/dist/) the live previews import, plus the loader map After a fresh clone, or after adding / renaming an example or a primitive
pnpm registry:build The public shadcn registry JSON in public/r/styles/** that the CLI serves Testing npx shadcn add @reui/... locally
pnpm registry:verify Validates the generated public/r/** registry JSON CI, or to sanity-check a registry build
pnpm registry:all Full verified pipeline: metadata, packages, registry, verify A complete rebuild from scratch

Which task when editing?

  • Examples (c-*) or in-house primitives (registry-reui/.../reui/ - Data Grid, Event Calendar, Gantt, Kanban, Filters, etc.) -> pnpm dev:packages (they are bundled, so plain dev shows a stale preview until the bundle is rebuilt)
  • shadcn base primitives (registry/.../ui/), site UI, lib/, hooks/ -> plain pnpm dev picks them up via Fast Refresh
  • Just running the site -> pnpm dev

Note

Plain pnpm dev does not rebuild the preview bundles. If a bundle is missing or stale, its category page hangs while compiling (look for Module not found: @reui/components-... in the dev logs); run pnpm components:packages once and reload.


Contributing

We welcome contributions - new examples, bug fixes, documentation improvements, and component additions all help the community.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/your-change)
  3. Add your changes with TypeScript types and accessibility features
  4. Open a pull request with a clear description

See CONTRIBUTING.md for full guidelines.


License

ReUI is open-source software licensed under the MIT License.