# ShellUI Documentation
> CLI-first Blazor component library inspired by shadcn/ui
Source: https://shellui.dev/docs/v0.4/introduction
Welcome to ShellUI v0.4.0, the current stable release of the CLI-first Blazor component library inspired by shadcn/ui. Compared with 0.3 it adds 19 components and three sign-in page blocks (98 install targets in all), compositional parts for eight more components, `shellui add all`, `doctor` and `migrate`, and .NET 8 and 9 support for both the CLI and the NuGet package.
v0.4.0 stable 98 install targets .NET 8, 9 & 10 tweakcn themes
> The CLI runs on .NET 8 or later and works in Blazor projects on .NET 8, 9 and 10. The `ShellUI.Components` NuGet package targets .NET 8, 9 and 10. Still on 0.3? See the [v0.3 docs](https://shellui.dev/docs/v0.3/introduction.md) and [upgrading from 0.3](https://shellui.dev/docs/v0.4/release-notes.md#upgrading-from-0.3).
## Getting Started
### Installation
Choose your preferred installation method:
**CLI Installation (Recommended)**
```bash
dotnet tool install -g ShellUI.CLI
# Or upgrade an existing install
dotnet tool update -g ShellUI.CLI
# Initialize in your Blazor project (safe to re-run)
shellui init
# Add components
shellui add button input card table chart drawer sheet
```
**NuGet Package**
```bash
dotnet add package ShellUI.Components
```
With the package, add `@using ShellUI.Components` to `_Imports.razor`, give the app an interactive render mode (for example ``), and link `_content/ShellUI.Components/shellui-all.css`. See the [NuGet guide](https://shellui.dev/docs/v0.4/installation/nuget.md).
### Quick Example
```razor
Welcome to ShellUI
Build beautiful Blazor applications
Your content goes here.
```
## Component Categories
Explore our comprehensive component library, organized by category:
- [Form Components](https://shellui.dev/docs/v0.4/components/form.md): Buttons, inputs, selects, and form controls
- [Layout Components](https://shellui.dev/docs/v0.4/components/layout.md): Cards, dialogs, sheets, and structural elements
- [Navigation Components](https://shellui.dev/docs/v0.4/components/navigation.md): Menus, breadcrumbs, tabs, and navigation elements
- [Interactive Components](https://shellui.dev/docs/v0.4/components/interactive.md): Dropdowns, tooltips, and interactive elements
- [Advanced Components](https://shellui.dev/docs/v0.4/components/advanced.md): Calendars, charts, carousels, steppers, and complex UI elements
## What's New in v0.4.0
The 0.4 line is stable. Since 0.4.0-alpha.3:
- **Six components for AI and app UIs:** [Prompt Suggestions](https://shellui.dev/docs/v0.4/components/advanced/prompt-suggestions.md), [Reasoning](https://shellui.dev/docs/v0.4/components/advanced/reasoning.md), [Tool Call](https://shellui.dev/docs/v0.4/components/advanced/tool-call.md), [Field](https://shellui.dev/docs/v0.4/components/form/field.md), [JSON Viewer](https://shellui.dev/docs/v0.4/components/data-display/json-viewer.md), and a real [Resizable](https://shellui.dev/docs/v0.4/components/layout/resizable.md) panel group you can drag or move with the keyboard.
- **`shellui add all`** installs the whole library (`--except` leaves components out), **`shellui doctor`** checks a project's setup, and **`shellui migrate`** rewrites your pages after a template API change. See the [CLI guide](https://shellui.dev/docs/v0.4/installation/cli.md).
- **.NET 8 and 9:** the CLI runs on .NET 8 or later, and the `ShellUI.Components` package targets .NET 8, 9 and 10.
- **`SonnerService.Clear()`** and **destructive [context menu](https://shellui.dev/docs/v0.4/components/interactive/context-menu.md) items.**
- **Fixes:** `add` no longer hangs on .NET 8 and 9 apps, `doctor` no longer calls a fresh `app.css` stale, `list` counts correctly, and the package safelist has the 198 classes it was missing. Everything in 0.3.5 and 0.3.6 is included. See the [release notes](https://shellui.dev/docs/v0.4/release-notes.md).
## What's New in v0.4.0-alpha.3
- **`Class` wins over a component's own classes:** `` replaces the card's `max-w-md` instead of competing with it, so the `!` modifier is no longer needed. See [Theming](https://shellui.dev/docs/v0.4/theming.md#per-component-changes).
- **Focus stays inside open overlays:** Dialog, Alert Dialog, Sheet and Drawer keep Tab inside while open and return focus when they close.
- **`shellui add` never downgrades a NuGet package** your project already has at the same or a newer version.
- **Razor class libraries:** `init` sets up a library shared by several apps. See [Razor Class Library](https://shellui.dev/docs/v0.4/installation/razor-class-library.md).
- **The CLI templates match the NuGet package,** fixing RadioGroup, ScrollArea, DatePicker, TimePicker, Sheet and Drawer, among others. After `shellui update`, `InputVariant` and the Stepper parts change: see the [release notes](https://shellui.dev/docs/v0.4/release-notes.md).
## What's New in v0.4.0-alpha.2
- **One Tailwind CLI per machine:** the standalone Tailwind CLI is downloaded once into `~/.shellui/bin` and shared by every project, so a new project is about 130 KB instead of 112 MB, and later projects set up offline. The download resumes over slow connections, and if it fails `init` still finishes.
- **`shellui update` keeps your changes** and installs new dependencies, so a project updated from 0.3 builds. **`shellui remove`** handles layouts and custom component paths.
- **Fixes:** dark mode sets `color-scheme` for the browser's own controls, and the NuGet package's `TimePicker` shows its value. Everything in 0.3.3 and 0.3.4 is included. See the [release notes](https://shellui.dev/docs/v0.4/release-notes.md).
## What's New in v0.4.0-alpha.1
- **14 new components:** [Kbd](https://shellui.dev/docs/v0.4/components/data-display/kbd.md), [Aspect Ratio](https://shellui.dev/docs/v0.4/components/layout/aspect-ratio.md), [Button Group](https://shellui.dev/docs/v0.4/components/form/button-group.md), [Toggle Group](https://shellui.dev/docs/v0.4/components/form/toggle-group.md), [Input Group](https://shellui.dev/docs/v0.4/components/form/input-group.md), [Number Input](https://shellui.dev/docs/v0.4/components/form/number-input.md), [Stat Card](https://shellui.dev/docs/v0.4/components/data-display/stat-card.md), [Timeline](https://shellui.dev/docs/v0.4/components/data-display/timeline.md), [Tree View](https://shellui.dev/docs/v0.4/components/data-display/tree-view.md), [QR Code](https://shellui.dev/docs/v0.4/components/data-display/qr-code.md), [Image Viewer](https://shellui.dev/docs/v0.4/components/advanced/image-viewer.md) and [Chat](https://shellui.dev/docs/v0.4/components/advanced/chat.md) with its message and input parts.
- **Compositional parts** for [Alert Dialog](https://shellui.dev/docs/v0.4/components/advanced/alert-dialog.md), [Breadcrumb](https://shellui.dev/docs/v0.4/components/layout/breadcrumb.md), [Command](https://shellui.dev/docs/v0.4/components/advanced/command.md), [Form](https://shellui.dev/docs/v0.4/components/form/form.md), [Menubar](https://shellui.dev/docs/v0.4/components/navigation/menubar.md), [Pagination](https://shellui.dev/docs/v0.4/components/navigation/pagination.md), [Sheet](https://shellui.dev/docs/v0.4/components/layout/sheet.md) and [Drawer](https://shellui.dev/docs/v0.4/components/layout/drawer.md). Each mode is opt-in, so existing markup keeps working.
- **Dashboard setup in `init`:** `shellui init --dashboard 02` makes the dashboard your app's layout, builds the sidebar links from your pages, and removes the template's layout when you haven't changed it. See the [dashboard guide](https://shellui.dev/docs/v0.4/dashboard.md), and try the layouts on the [Blocks page](https://shellui.dev/blocks).
- **ASP.NET Core Identity:** apps created with `--auth Individual` work after `init`, the sidebar shows the signed-in user, and the `auth-01`, `auth-02` and `auth-03` blocks restyle the sign-in pages. See the [authentication guide](https://shellui.dev/docs/v0.4/authentication.md).
- **[Loading](https://shellui.dev/docs/v0.4/components/data-display/loading.md)** has 23 variants, and **Command** and **Command Palette** filter as you type, support the arrow keys and run each item's `Action`.
- **One breaking change:** `Calendar.SelectedDateChanged` is now `EventCallback`.
See the [release notes](https://shellui.dev/docs/v0.4/release-notes.md) for the full list and how to upgrade from 0.3.
## Key Features
- **CLI-First**: Copy components directly to your codebase for full control
- **Hybrid Workflow**: CLI + NuGet packages for maximum flexibility
- **Tailwind CSS v4.3.2**: Modern styling with standalone CLI (no Node.js required)
- **Production-Ready Components**: Comprehensive component library
- **Type-Safe Variants**: CVA patterns with full C# type safety
- **Accessible**: WCAG 2.1 AA compliant by default
- **Performance Optimized**: Built for both Server and WASM scenarios
- **Customizable**: Easy theme customization with CSS variables
## Architecture
ShellUI offers a unique hybrid approach:
- **Copy Components**: Like shadcn/ui, components are copied to your project
- **NuGet Option**: Traditional package installation for quick starts
- **Tailwind Integration**: Standalone CLI or npm setup options
- **Build Integration**: Automatic CSS compilation on project build
## Theming
Customize your theme instantly with [tweakcn](https://tweakcn.com) or modify CSS variables:
```css
:root {
--background: oklch(0.9900 0 0);
--foreground: oklch(0 0 0);
--primary: oklch(0 0 0);
--primary-foreground: oklch(1 0 0);
--secondary: oklch(0.9400 0 0);
--secondary-foreground: oklch(0 0 0);
/* ... more variables */
}
```
## Learn More
- [GitHub Repository](https://github.com/shellui-dev/shellui)
- [Installation Guide](https://shellui.dev/docs/v0.4/installation.md)
- [Component API](https://shellui.dev/docs/v0.4/components.md)
- [Theming Guide](https://shellui.dev/docs/v0.4/theming.md)
- [Contributing](https://shellui.dev/docs/v0.4/contributing.md)