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.

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 and 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 <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 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.
  • .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 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.

What's New in v0.4.0-alpha.3

  • Class wins over a component's own classes: <Card Class="max-w-lg"> replaces the card's max-w-md instead 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 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.
  • 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.

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.

What's New in v0.4.0-alpha.1

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:

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.