ShellUI Documentation
CLI-first Blazor component library inspired by shadcn/ui
Welcome to ShellUI v0.3.6, the latest release of the 0.3 line of the CLI-first Blazor component library inspired by shadcn/ui. It ships 76 components, Tailwind CSS 4.3.2, and everything from the 0.3.0 alphas and release candidates.
ShellUI 0.4.0 is the current stable release: see the v0.4 docs. These pages cover 0.3.6, so their install commands name --version 0.3.6; without it, dotnet tool install and dotnet add package get 0.4.
The CLI needs the .NET 10 SDK and works in Blazor projects on .NET 8, 9 and 10. The
ShellUI.ComponentsNuGet package targets .NET 10 only; on .NET 8 or 9, use the CLI.
Getting Started
Installation
Choose your preferred installation method:
CLI Installation (Recommended)
dotnet tool install -g ShellUI.CLI --version 0.3.6
# Or upgrade an existing install
dotnet tool update -g ShellUI.CLI --version 0.3.6
# 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 --version 0.3.6
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.3.6
- Safelist:
shellui-classes.txt, used by apps that build their own Tailwind CSS from the NuGet package, now has the 181 classes it was missing, among them the dialog's centring and the Sonner variant colours. The precompiledshellui-all.csswasn't affected. - Package icon:
ShellUI.CLIandShellUI.Componentsshow the ShellUI logo on nuget.org. See the release notes.
What's New in v0.3.5
The 0.4 prerelease fixes come to the stable line:
- One Tailwind CLI per machine:
initno longer downloads the 112 MB Tailwind CLI into every project. It lives once in~/.shellui/bin, downloads resume over slow connections, and a failed download no longer stopsinit. shellui updatekeeps your changes and installs dependencies a component gained;shellui removehonours a custom components path and removes the dashboard layouts;shellui addnever downgrades a NuGet package.Classwins over a component's own classes, so the!modifier is no longer needed. See Theming.- Focus stays inside open overlays (Dialog, Alert Dialog, Sheet, Drawer), and fixes to RadioGroup, ScrollArea, DatePicker, TimePicker, Sheet, Drawer and Label.
- Razor class libraries: see Razor Class Library.
See the release notes.
What's New in v0.3.4
Dark mode fixes: the themes set color-scheme, so the browser draws its own controls (date pickers, number spinners, scrollbars, autofill, <select> lists) dark on a dark page. The NuGet package's TimePicker shows its value instead of throwing. See the release notes.
What's New in v0.3.3
Command runs each item's Action when you pick it, Dropdown and Popover close on Escape, the CLI sidebar no longer logs JSDisconnectedException on every reload, and the package's shellui-theme.css no longer logs a 404. See the release notes.
What's New in v0.3.2
Fixes for the ShellUI.Components NuGet package and the CLI templates. MultiSeriesChart renders again, ThemeToggle changes the page theme, and dialogs, sheets and drawers lock page scrolling. The package's shellui.js now loads on its own, so no <script> tag is needed. See the release notes.
What's New in v0.3.1
A patch for the ShellUI.Components NuGet package: Calendar, Command, DataTable, FileUpload and the Carousel parts now live in the ShellUI.Components namespace like every other component, so @using ShellUI.Components is all you need. If you added @using ShellUI.Components.Components on 0.3.0, remove it. See the release notes.
What's Fixed in v0.3.0
Everything from the alpha series, plus the fixes from the release candidates:
- Template compilation:
ChartVariants,PieChart, andDashboardLayout02templates had uncompilable C# with improperly escaped quotes in verbatim strings — fixed. Same backslash-escaping bug fixed in the livePieChart.razor. - CSP-safe runtime:
ThemeToggle,InputOTP, andThemeServiceno longer useeval(). localStorage reads moved to proper Blazor lifecycle methods. - Idempotent
shellui init: patchesApp.razorwith render modes, theme bootstrap scripts, andshellui.jsreferences. Writes the full default theme toinput.cssinstead of just the Tailwind import. Re-running is safe. - Component install fixes:
shellui add data-tablenow properly installsDataTableModels.csand auto-installs NuGet dependencies (System.Linq.Dynamic.Core,Blazor-ApexCharts). Chart tooltips render readable text instead of invisible white-on-white. - CLI ergonomics: typo suggestions added (e.g. "Did you mean 'data-table'?").
- SidebarTrigger: now uses inline SVG instead of FontAwesome dependency for the mobile hamburger menu.
- Component count: 76 installable components; sub-components, variants and models install automatically with them.
Also in 0.3.0:
- Drawer/Sheet compositional pattern:
DrawerTrigger,DrawerContent,SheetTrigger,SheetContent— no external open state required - Compositional APIs across NavigationMenu, Tabs, Dropdown, Popover, Collapsible, and Accordion
- Components added during alphas: Callout, CopyButton, LinkCard, PrevNextNav, Sonner, Stepper
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 */
}