ShellUI Documentation
CLI-first Blazor component library inspired by shadcn/ui
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.
The CLI runs on .NET 8 or later and works in Blazor projects on .NET 8, 9 and 10. The
ShellUI.ComponentsNuGet package targets .NET 8, 9 and 10. Still on 0.3? See the v0.3 docs and upgrading from 0.3.
Getting Started
Installation
Choose your preferred installation method:
CLI Installation (Recommended)
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
dotnet add package ShellUI.Components
With the package, add @using ShellUI.Components to _Imports.razor, give the app an interactive render mode (for example <Routes @rendermode="InteractiveServer" />), and link _content/ShellUI.Components/shellui-all.css. See the NuGet guide.
Quick Example
Welcome to ShellUI
Build beautiful Blazor applications
Your content goes here.
<Card>
<CardHeader>
<CardTitle>Welcome to ShellUI</CardTitle>
<CardDescription>Build beautiful Blazor applications</CardDescription>
</CardHeader>
<CardContent>
<p>Your content goes here.</p>
</CardContent>
</Card>Component Categories
Explore our comprehensive component library, organized by category:
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, Reasoning, Tool Call, Field, JSON Viewer, and a real Resizable panel group you can drag or move with the keyboard.
shellui add allinstalls the whole library (--exceptleaves components out),shellui doctorchecks a project's setup, andshellui migraterewrites your pages after a template API change. See the CLI guide.- .NET 8 and 9: the CLI runs on .NET 8 or later, and the
ShellUI.Componentspackage targets .NET 8, 9 and 10. SonnerService.Clear()and destructive context menu items.- Fixes:
addno longer hangs on .NET 8 and 9 apps,doctorno longer calls a freshapp.cssstale,listcounts 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.
What's New in v0.4.0-alpha.3
Classwins over a component's own classes:<Card Class="max-w-lg">replaces the card'smax-w-mdinstead of competing with it, so the!modifier is no longer needed. See Theming.- Focus stays inside open overlays: Dialog, Alert Dialog, Sheet and Drawer keep Tab inside while open and return focus when they close.
shellui addnever downgrades a NuGet package your project already has at the same or a newer version.- Razor class libraries:
initsets up a library shared by several apps. See Razor Class Library. - The CLI templates match the NuGet package, fixing RadioGroup, ScrollArea, DatePicker, TimePicker, Sheet and Drawer, among others. After
shellui update,InputVariantand the Stepper parts change: see the release notes.
What's New in v0.4.0-alpha.2
- One Tailwind CLI per machine: the standalone Tailwind CLI is downloaded once into
~/.shellui/binand 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 failsinitstill finishes. shellui updatekeeps your changes and installs new dependencies, so a project updated from 0.3 builds.shellui removehandles layouts and custom component paths.- Fixes: dark mode sets
color-schemefor the browser's own controls, and the NuGet package'sTimePickershows its value. Everything in 0.3.3 and 0.3.4 is included. See the release notes.
What's New in v0.4.0-alpha.1
- 14 new components: Kbd, Aspect Ratio, Button Group, Toggle Group, Input Group, Number Input, Stat Card, Timeline, Tree View, QR Code, Image Viewer and Chat with its message and input parts.
- Compositional parts for Alert Dialog, Breadcrumb, Command, Form, Menubar, Pagination, Sheet and Drawer. Each mode is opt-in, so existing markup keeps working.
- Dashboard setup in
init:shellui init --dashboard 02makes 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, and try the layouts on the Blocks page. - ASP.NET Core Identity: apps created with
--auth Individualwork afterinit, the sidebar shows the signed-in user, and theauth-01,auth-02andauth-03blocks restyle the sign-in pages. See the authentication guide. - Loading 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.SelectedDateChangedis nowEventCallback<DateTime?>.
See the release notes 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 or modify CSS variables:
: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 */
}