# ShellUI > ShellUI is a shadcn/ui-style component library for Blazor. Components are installed into your project as source files with the `shellui` CLI, or used from the `ShellUI.Components` NuGet package. These docs are for v0.4.0. Other versions: [v0.3.6](https://shellui.dev/docs/v0.3/llms.txt), [v0.2.1](https://shellui.dev/docs/v0.2.1/llms.txt). ## Rules for AI agents Read these before writing UI in a ShellUI project. 1. **Use ShellUI's components; don't write your own.** Before building a button, input, dialog, sheet, dropdown, table, chart, sidebar or any other UI element, check whether ShellUI has it. `llms.txt` lists every component with its `shellui add` command. 2. **Check what the project already has.** - `shellui.json` in the project root means the project uses the CLI. `InstalledComponents` lists what's installed and `ComponentsPath` says where (default `Components/UI`). - `shellui list --installed` and `shellui list --available` print the same from the terminal. - A `PackageReference` to `ShellUI.Components` in the `.csproj` means the project uses the NuGet package, which already contains every component. 3. **Install a missing component; never recreate it.** Run `shellui add `, or several at once: `shellui add button card dialog`. Don't hand-write a file with a ShellUI component's name, port one from shadcn/ui (React), or build a look-alike in another folder. `add` also installs the sub-components, models, variants and NuGet packages a component needs, and adds the `@using` lines to `_Imports.razor`. 4. **CLI projects own the source.** Installed components are ordinary `.razor` files in `Components/UI`, in the `.Components.UI` namespace, and may be edited. Package projects use `@using ShellUI.Components` and link `_content/ShellUI.Components/shellui-all.css`; `shellui add` isn't used there. Pick one per project: both define the same component names. 5. **Give components an interactive render mode.** Set it app-wide with `` in `App.razor`, or per page with `@rendermode InteractiveServer`. Under static server rendering, components render but clicks, dialogs, dropdowns and toggles do nothing. 6. **Follow the API reference.** Each component page has a parameter table. Variants and sizes are enums (`Variant="ButtonVariant.Destructive"`, `Size="ButtonSize.Sm"`). Add classes with `Class` (`ClassName` is deprecated). Don't guess parameter names. 7. **Style with the theme tokens.** ShellUI uses Tailwind CSS v4 and shadcn-style tokens: `bg-background`, `text-foreground`, `bg-primary`, `text-primary-foreground`, `bg-muted`, `text-muted-foreground`, `border-border`, `bg-card`, `ring-ring`. Use them instead of fixed colors so dark mode keeps working. The theme lives in `wwwroot/input.css`; `shellui theme apply ` replaces it with a tweakcn theme. 8. **Copy the examples.** The Razor examples on each component page are the source of working demos, so they compile as shown. 9. **Match the version.** `shellui --version` (or the `ShellUI.Components` version in the `.csproj`) says which docs apply. Read the release notes before upgrading: `shellui update` rewrites installed components from the CLI's templates (and keeps files you changed). From 0.4, run `shellui migrate` after `update` to rewrite pages for template API changes, and `shellui doctor` to check the project's setup. The [full text](https://shellui.dev/docs/v0.4/llms-full.txt) has every page below in one file. ## Getting Started - [ShellUI Documentation](https://shellui.dev/docs/v0.4/introduction.md): CLI-first Blazor component library inspired by shadcn/ui. Install: `shellui add button input card table chart drawer sheet` - [Quickstart](https://shellui.dev/docs/v0.4/quickstart.md): Get started with ShellUI in minutes. Install: `shellui add button input card dialog` - [Installation](https://shellui.dev/docs/v0.4/installation.md): Install ShellUI via CLI or NuGet package. Install: `shellui add button input card dialog` - [CLI Installation](https://shellui.dev/docs/v0.4/installation/cli.md): Install ShellUI via the CLI tool for full component ownership and automatic Tailwind setup. Install: `shellui add button input card` - [NuGet Installation](https://shellui.dev/docs/v0.4/installation/nuget.md): Step-by-step guide for installing ShellUI via NuGet package with manual Tailwind CSS setup. - [Razor Class Library](https://shellui.dev/docs/v0.4/installation/razor-class-library.md): Share ShellUI components, the theme and the CSS between a Blazor Web App and a MAUI Blazor Hybrid app through one Razor class library. Install: `shellui add button card dialog` - [Comparison](https://shellui.dev/docs/v0.4/comparison.md): How ShellUI compares to other Blazor UI libraries. - [AI Agents](https://shellui.dev/docs/v0.4/ai-agents.md): Point Claude Code, Cursor, Copilot and other coding agents at the ShellUI docs, so they use its components instead of writing their own. ## Guides - [Dashboard Layout](https://shellui.dev/docs/v0.4/dashboard.md): Set up the ShellUI dashboard (sidebar, header, breadcrumb, theme toggle) as your app's layout with one command. Install: `shellui add dashboard-02` - [Authentication](https://shellui.dev/docs/v0.4/authentication.md): Use ShellUI in apps with ASP.NET Core Identity, and style the sign-in pages with the auth blocks. Install: `shellui add auth-01` - [Theming](https://shellui.dev/docs/v0.4/theming.md): Apply a tweakcn theme from the CLI, or customize the CSS variables yourself. ## Components - [Components](https://shellui.dev/docs/v0.4/components.md): Browse all ShellUI 0.4 components organized by category. Install: `shellui add button input card drawer sheet` ## Components / Form - [Form Components](https://shellui.dev/docs/v0.4/components/form.md): Form components for ShellUI 0.4. - [Button](https://shellui.dev/docs/v0.4/components/form/button.md): Interactive button component with type-safe variants, sizes, and loading state. Install: `shellui add button` - [Button Group](https://shellui.dev/docs/v0.4/components/form/button-group.md): Joins related buttons into one control, horizontally or vertically. Install: `shellui add button-group` - [Checkbox](https://shellui.dev/docs/v0.4/components/form/checkbox.md): Boolean input with checkbox styling and two-way binding. Install: `shellui add checkbox` - [Data Picker](https://shellui.dev/docs/v0.4/components/form/data-picker.md): Searchable single-select for objects, with custom templates. Install: `shellui add data-picker` - [Field](https://shellui.dev/docs/v0.4/components/form/field.md): Label, control, description and validation message as one unit. Install: `shellui add field` - [Form](https://shellui.dev/docs/v0.4/components/form/form.md): Form wrapper component with validation and submission handling. Install: `shellui add form` - [Input](https://shellui.dev/docs/v0.4/components/form/input.md): Text input field component with variant support and two-way binding. Install: `shellui add input` - [Input Group](https://shellui.dev/docs/v0.4/components/form/input-group.md): A text input with a prefix, a suffix, or both. Install: `shellui add input-group` - [Input OTP](https://shellui.dev/docs/v0.4/components/form/input-otp.md): One-time password input field with auto-focus and grouping. Install: `shellui add input-otp` - [Label](https://shellui.dev/docs/v0.4/components/form/label.md): Accessible form label component for input association. Install: `shellui add label` - [Multi Select](https://shellui.dev/docs/v0.4/components/form/multi-select.md): Searchable multi-select for objects, shown as chips. Install: `shellui add multi-select` - [Number Input](https://shellui.dev/docs/v0.4/components/form/number-input.md): A numeric input with decrease and increase buttons, limits and a step. Install: `shellui add number-input` - [Radio Group](https://shellui.dev/docs/v0.4/components/form/radio-group.md): Radio button group for single selection from multiple choices. Install: `shellui add radio-group` - [Select](https://shellui.dev/docs/v0.4/components/form/select.md): Dropdown select input for picking from a list of options, styled to match the ShellUI design system. Install: `shellui add select` - [Slider](https://shellui.dev/docs/v0.4/components/form/slider.md): Range input slider component for selecting numeric values. Install: `shellui add slider` - [Switch](https://shellui.dev/docs/v0.4/components/form/switch.md): Toggle switch component for boolean selections. Install: `shellui add switch` - [Tag Input](https://shellui.dev/docs/v0.4/components/form/tag-input.md): Free-text tags with keyboard and paste support. Install: `shellui add tag-input` - [Textarea](https://shellui.dev/docs/v0.4/components/form/textarea.md): Multi-line text input component with two-way binding. Install: `shellui add textarea` - [Toggle](https://shellui.dev/docs/v0.4/components/form/toggle.md): Pressable toggle button with variant and size support. Install: `shellui add toggle` - [Toggle Group](https://shellui.dev/docs/v0.4/components/form/toggle-group.md): A set of toggles where one, or several, can be on at a time. Install: `shellui add toggle-group` - [Typed Select](https://shellui.dev/docs/v0.4/components/form/typed-select.md): Native select bound to a typed value: enums, numbers, Guids, bools or strings. Install: `shellui add typed-select` ## Components / Data Display - [Data Display Components](https://shellui.dev/docs/v0.4/components/data-display.md): Components for displaying data in tables, lists, and other structured formats. Install: `shellui add table badge avatar alert toast` - [Alert](https://shellui.dev/docs/v0.4/components/data-display/alert.md): Status message component using the AlertVariant enum for Default and Destructive styles. Install: `shellui add alert` - [Avatar](https://shellui.dev/docs/v0.4/components/data-display/avatar.md): User profile image with fallback initials and size control via the AvatarSize enum. Install: `shellui add avatar` - [Badge](https://shellui.dev/docs/v0.4/components/data-display/badge.md): Compact status indicator using the BadgeVariant enum for visual style control. Install: `shellui add badge` - [JSON Viewer](https://shellui.dev/docs/v0.4/components/data-display/json-viewer.md): A highlighted, foldable JSON tree with a copy button. Install: `shellui add json-viewer` - [Kbd](https://shellui.dev/docs/v0.4/components/data-display/kbd.md): Shows a keyboard key or shortcut. Install: `shellui add kbd` - [Loading](https://shellui.dev/docs/v0.4/components/data-display/loading.md): Loading spinners and animation indicators. Install: `shellui add loading` - [Progress](https://shellui.dev/docs/v0.4/components/data-display/progress.md): Determinate progress bar with configurable value and height. Install: `shellui add progress` - [QR Code](https://shellui.dev/docs/v0.4/components/data-display/qr-code.md): Renders a QR code as inline SVG. Install: `shellui add qr-code` - [Skeleton](https://shellui.dev/docs/v0.4/components/data-display/skeleton.md): Loading state placeholder with pulse animation. Install: `shellui add skeleton` - [Stat Card](https://shellui.dev/docs/v0.4/components/data-display/stat-card.md): A KPI tile with a value, a trend badge and a caption. Install: `shellui add stat-card` - [Table](https://shellui.dev/docs/v0.4/components/data-display/table.md): Compound component for structured tabular data with semantic HTML. Install: `shellui add table` - [Timeline](https://shellui.dev/docs/v0.4/components/data-display/timeline.md): A vertical list of events in order. Install: `shellui add timeline` - [Toast](https://shellui.dev/docs/v0.4/components/data-display/toast.md): Non-intrusive notification messages. Install: `shellui add toast` - [Tree View](https://shellui.dev/docs/v0.4/components/data-display/tree-view.md): An expandable tree with a selectable item. Install: `shellui add tree-view` ## Components / Layout - [Layout Components](https://shellui.dev/docs/v0.4/components/layout.md): Layout components for ShellUI 0.4. - [Aspect Ratio](https://shellui.dev/docs/v0.4/components/layout/aspect-ratio.md): Keeps its content at a fixed width-to-height ratio. Install: `shellui add aspect-ratio` - [Breadcrumb](https://shellui.dev/docs/v0.4/components/layout/breadcrumb.md): Navigation breadcrumb trail for hierarchical page structure. Install: `shellui add breadcrumb` - [Card](https://shellui.dev/docs/v0.4/components/layout/card.md): Compound container component for organizing and displaying content with visual hierarchy. Install: `shellui add card` - [Accordion](https://shellui.dev/docs/v0.4/components/layout/accordion.md): Expandable content sections with the new compositional Trigger + Content pattern. Install: `shellui add accordion` - [Collapsible](https://shellui.dev/docs/v0.4/components/layout/collapsible.md): Toggle-able content section with the new CollapsibleTrigger and CollapsibleContent subcomponents. Install: `shellui add collapsible` - [Dialog](https://shellui.dev/docs/v0.4/components/layout/dialog.md): Compound modal dialog overlay for displaying content that requires user attention. Install: `shellui add dialog` - [Drawer](https://shellui.dev/docs/v0.4/components/layout/drawer.md): Bottom/side drawer panel with new DrawerTrigger and DrawerContent subcomponents. Install: `shellui add drawer` - [Popover](https://shellui.dev/docs/v0.4/components/layout/popover.md): Floating content panel with the new PopoverTrigger and PopoverContent subcomponents. Install: `shellui add popover` - [Resizable](https://shellui.dev/docs/v0.4/components/layout/resizable.md): Panels the user can resize by dragging a handle or with the keyboard. Install: `shellui add resizable` - [Separator](https://shellui.dev/docs/v0.4/components/layout/separator.md): Visual divider for separating content sections horizontally or vertically. Install: `shellui add separator` - [Sheet](https://shellui.dev/docs/v0.4/components/layout/sheet.md): Slide-out panel with new SheetTrigger and SheetContent subcomponents. Install: `shellui add sheet` - [Tooltip](https://shellui.dev/docs/v0.4/components/layout/tooltip.md): Contextual hover information display. Install: `shellui add tooltip` ## Components / Navigation - [Navigation Components](https://shellui.dev/docs/v0.4/components/navigation.md): Navigation components for ShellUI 0.4. - [Menubar](https://shellui.dev/docs/v0.4/components/navigation/menubar.md): A horizontal bar of menus, like a desktop application's menu bar. Install: `shellui add menubar` - [Navbar](https://shellui.dev/docs/v0.4/components/navigation/navbar.md): Sticky top navigation bar with backdrop blur. Install: `shellui add navbar` - [Navigation Menu](https://shellui.dev/docs/v0.4/components/navigation/navigation-menu.md): Top navigation bar with new NavItem, NavList, NavTrigger, and NavContent subcomponents. Install: `shellui add navigation-menu nav-item nav-list nav-trigger nav-content` - [Pagination](https://shellui.dev/docs/v0.4/components/navigation/pagination.md): Page navigation controls for paginated content. Install: `shellui add pagination` - [PrevNextNav](https://shellui.dev/docs/v0.4/components/navigation/prev-next-nav.md): Previous/Next page navigation links — new in v0.3.0. Install: `shellui add prev-next-nav` - [Tabs](https://shellui.dev/docs/v0.4/components/navigation/tabs.md): Tabbed content with the new compositional TabsList, TabsTrigger, and TabsContent subcomponents. Install: `shellui add tabs` ## Components / Interactive - [Interactive Components](https://shellui.dev/docs/v0.4/components/interactive.md): Interactive components for ShellUI 0.4. - [Context Menu](https://shellui.dev/docs/v0.4/components/interactive/context-menu.md): Right-click context menu using the new compositional ContextMenuTrigger and ContextMenuContent subcomponents. Install: `shellui add context-menu` - [Dropdown](https://shellui.dev/docs/v0.4/components/interactive/dropdown.md): Dropdown menu with new DropdownTrigger, DropdownContent, and DropdownItem subcomponents. Install: `shellui add dropdown` - [Empty State](https://shellui.dev/docs/v0.4/components/interactive/empty-state.md): Placeholder for empty content areas with optional actions. Install: `shellui add empty-state` - [Hover Card](https://shellui.dev/docs/v0.4/components/interactive/hover-card.md): Hover-triggered floating card with new HoverCardTrigger and HoverCardContent subcomponents. Install: `shellui add hover-card` - [Theme Toggle](https://shellui.dev/docs/v0.4/components/interactive/theme-toggle.md): Dark/light mode toggle with localStorage persistence. Install: `shellui add theme-toggle` ## Components / Advanced - [Advanced Components](https://shellui.dev/docs/v0.4/components/advanced.md): Advanced components for ShellUI 0.4. - [Alert Dialog](https://shellui.dev/docs/v0.4/components/advanced/alert-dialog.md): Confirmation dialog requiring explicit user action. Install: `shellui add alert-dialog` - [Calendar](https://shellui.dev/docs/v0.4/components/advanced/calendar.md): Date selection calendar component. Install: `shellui add calendar` - [Carousel](https://shellui.dev/docs/v0.4/components/advanced/carousel.md): Content carousel using TotalSlides + CarouselItem. Subcomponents auto-installed as dependencies. Install: `shellui add carousel` - [Callout](https://shellui.dev/docs/v0.4/components/advanced/callout.md): Admonition boxes for info, warnings, tips, and danger notices — new in v0.3.0. Install: `shellui add callout` - [Charts](https://shellui.dev/docs/v0.4/components/advanced/charts.md): Data visualization components built on ApexCharts.Blazor with theme-aware styling. Install: `shellui add chart bar-chart line-chart pie-chart area-chart multi-series-chart` - [Bar Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/bar-chart.md): Vertical bar charts for comparing values across categories. Install: `shellui add chart bar-chart` - [Line Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/line-chart.md): Smooth line charts for showing trends over time. Install: `shellui add chart line-chart` - [Area Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/area-chart.md): Filled area charts for showing volume and trends. Install: `shellui add chart area-chart` - [Pie Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/pie-chart.md): Pie charts with custom HTML tooltips for showing proportions. Install: `shellui add chart pie-chart` - [Donut Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/donut-chart.md): Donut charts for part-to-whole data. Install: `shellui add donut-chart` - [Radar Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/radar-chart.md): Radar charts for comparing values across categories. Install: `shellui add radar-chart` - [Radial Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/radial-chart.md): Radial bar charts for progress and percentages. Install: `shellui add radial-chart` - [Multi-Series Chart](https://shellui.dev/docs/v0.4/components/advanced/charts/multi-series-chart.md): Display multiple data series with mixed chart types on a single chart. Install: `shellui add chart multi-series-chart` - [Chat](https://shellui.dev/docs/v0.4/components/advanced/chat.md): A chat panel, message bubbles and a prompt input for AI and messaging UIs. Install: `shellui add chat` - [Combobox](https://shellui.dev/docs/v0.4/components/advanced/combobox.md): Searchable dropdown with filtering and selection. Install: `shellui add combobox` - [Command](https://shellui.dev/docs/v0.4/components/advanced/command.md): A searchable command menu, as a dialog or composed inline from parts. Install: `shellui add command` - [Command Palette](https://shellui.dev/docs/v0.4/components/advanced/command-palette.md): Keyboard-launched command menu (Ctrl+K or Cmd+K). Install: `shellui add command-palette` - [CopyButton](https://shellui.dev/docs/v0.4/components/advanced/copy-button.md): One-click clipboard copy button — new in v0.3.0. Install: `shellui add copy-button` - [Date Picker](https://shellui.dev/docs/v0.4/components/advanced/date-picker.md): Date input with calendar popup for date selection. Install: `shellui add date-picker` - [Image Viewer](https://shellui.dev/docs/v0.4/components/advanced/image-viewer.md): A thumbnail that opens the image in a zoomable lightbox. Install: `shellui add image-viewer` - [LinkCard](https://shellui.dev/docs/v0.4/components/advanced/link-card.md): Card-style navigation link — new in v0.3.0. Install: `shellui add link-card` - [Prompt Suggestions](https://shellui.dev/docs/v0.4/components/advanced/prompt-suggestions.md): Clickable suggestion chips that start a chat. Install: `shellui add prompt-suggestions` - [Reasoning](https://shellui.dev/docs/v0.4/components/advanced/reasoning.md): A collapsible block that streams a model's thinking. Install: `shellui add reasoning` - [Sonner](https://shellui.dev/docs/v0.4/components/advanced/sonner.md): Modern toast notifications — new in v0.3.0. Install: `shellui add sonner` - [Stepper](https://shellui.dev/docs/v0.4/components/advanced/stepper.md): Multi-step wizard with a new compositional StepperList, StepperStep, and StepperContent API. Install: `shellui add stepper` - [Tool Call](https://shellui.dev/docs/v0.4/components/advanced/tool-call.md): A collapsible card for an AI tool call, with its state, arguments and result. Install: `shellui add tool-call` ## Resources - [Release Notes](https://shellui.dev/docs/v0.4/release-notes.md): What changed in the ShellUI 0.4 line, and how to upgrade. - [Contributing](https://shellui.dev/docs/v0.4/contributing.md): Contribute to ShellUI development.