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.

0.4 is the current release

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.

v0.3.6
76 components
.NET 8, 9 & 10 (CLI)
tweakcn themes

The CLI needs the .NET 10 SDK and works in Blazor projects on .NET 8, 9 and 10. The ShellUI.Components NuGet package targets .NET 10 only; on .NET 8 or 9, use the CLI.

Getting Started

Installation

Choose your preferred installation method:

CLI Installation (Recommended)

bash
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

bash
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 precompiled shellui-all.css wasn't affected.
  • Package icon: ShellUI.CLI and ShellUI.Components show 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: init no 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 stops init.
  • shellui update keeps your changes and installs dependencies a component gained; shellui remove honours a custom components path and removes the dashboard layouts; shellui add never downgrades a NuGet package.
  • Class wins 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, and DashboardLayout02 templates had uncompilable C# with improperly escaped quotes in verbatim strings — fixed. Same backslash-escaping bug fixed in the live PieChart.razor.
  • CSP-safe runtime: ThemeToggle, InputOTP, and ThemeService no longer use eval(). localStorage reads moved to proper Blazor lifecycle methods.
  • Idempotent shellui init: patches App.razor with render modes, theme bootstrap scripts, and shellui.js references. Writes the full default theme to input.css instead of just the Tailwind import. Re-running is safe.
  • Component install fixes: shellui add data-table now properly installs DataTableModels.cs and 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:

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

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.