# 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)