ShellUI.CLI
0.3.0-rc.1
See the version list below for details.
dotnet tool install --global ShellUI.CLI --version 0.3.0-rc.1
dotnet new tool-manifest
dotnet tool install --local ShellUI.CLI --version 0.3.0-rc.1
#tool dotnet:?package=ShellUI.CLI&version=0.3.0-rc.1&prerelease
nuke :add-package ShellUI.CLI --version 0.3.0-rc.1
ShellUI CLI
Command-line tool for managing ShellUI Blazor components. Install components individually with a simple command.
Installation
dotnet tool install -g ShellUI.CLI
Quick Start
Initialize ShellUI in your project
dotnet shellui init
This automatically:
- ✅ Downloads Tailwind CSS CLI (standalone, no Node.js required) — or uses your npm install if you prefer
- ✅ Writes the full default theme (
:root,.dark,@theme inline) towwwroot/input.css - ✅ Patches
Components/App.razorwith@rendermode="InteractiveServer", a theme-bootstrap<script>(no light-flash on dark pages), and the<script src="shellui.js">tag - ✅ Patches
wwwroot/index.htmlinstead for Blazor WebAssembly standalone projects - ✅ Sets up MSBuild integration so Tailwind rebuilds on every
dotnet build - ✅ Creates the
Components/UI/folder structure - ✅ Idempotent — running it twice is a no-op
Add components
# Add a single component
dotnet shellui add button
# Add multiple components
dotnet shellui add input card dialog table
# List all available components
dotnet shellui list
# List installed components
dotnet shellui list --installed
Commands
init
Initialize ShellUI in your Blazor project.
dotnet shellui init
Options:
--force- Overwrite existing files--style <style>- Choose CSS style (default: default)--tailwind <method>- Choose Tailwind method (standalone, npm) (default: standalone)--yes- Run in non-interactive mode with default options
add <components>
Add one or more components to your project.
dotnet shellui add button input card
Options:
--force- Overwrite existing components
list
List available or installed components.
# List all available components
dotnet shellui list
# List installed components
dotnet shellui list --installed
# List available components
dotnet shellui list --available
remove <components>
Remove components from your project.
dotnet shellui remove button input
Options:
--all- Remove all installed components
Available Components
Form Components
button,input,textarea,select,checkbox,switch,radio-group,slider,combobox,date-picker,time-picker,date-range-picker,input-otp,form
Layout Components
card,dialog,sheet,drawer,popover,tooltip,separator,scroll-area,resizable,collapsible
Navigation Components
navbar,sidebar,app-sidebar,navigation-menu,menubar,breadcrumb,pagination,tabs
Dashboard / Layout Blocks (shadcn-style)
dashboard-01- Sidebar + content layout. Header scrolls with page.dashboard-02- Same layout with sticky header (breadcrumb bar stays fixed on scroll)
dotnet shellui add dashboard-01 # or dashboard-02
# Installs: sidebar, breadcrumb, separator, theme-toggle, app-sidebar + layout to Components/Layout/
Data Display
table,data-table,badge,avatar,alert,toast,sonner,skeleton,progress,loading
68 installable components total (run dotnet shellui list for full list; sub-components, variants, models, and services auto-install as dependencies)
Interactive Components
dropdown,accordion,toggle,theme-toggle,command,context-menu,hover-card
Component Dependencies
When you install a component, its dependencies are automatically installed:
dotnet shellui add dialog
# Automatically installs: button (dependency)
Project Structure
After running init, your project structure:
| Path | Purpose |
|---|---|
Components/UI/ |
Components are installed here |
wwwroot/input.css |
Tailwind input file |
wwwroot/app.css |
Compiled CSS (auto-generated) |
tailwind.config.js |
Tailwind configuration |
shellui.json |
ShellUI configuration |
Build/ShellUI.targets |
MSBuild integration |
Updating Components
To update a component to the latest version:
dotnet shellui add button --force
Troubleshooting
Component not found
Make sure you're using the correct component name. Use dotnet shellui list to see all available components.
Build errors
Ensure Tailwind CSS is properly configured:
- Run
dotnet shellui initif you haven't already - Check that
tailwind.config.jsexists - Verify
wwwroot/input.csscontains@import "tailwindcss";
CLI not found
Reinstall the CLI tool:
dotnet tool uninstall -g ShellUI.CLI
dotnet tool install -g ShellUI.CLI
Documentation
License
MIT License - see LICENSE for details.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.4.0 | 114 | 10/30/2026 |
| 0.4.0-alpha.3 | 79 | 10/20/2026 |
| 0.4.0-alpha.2 | 70 | 10/13/2026 |
| 0.4.0-alpha.1 | 87 | 10/3/2026 |
| 0.3.6 | 111 | 10/22/2026 |
| 0.3.5 | 99 | 10/21/2026 |
| 0.3.4 | 105 | 10/13/2026 |
| 0.3.3 | 104 | 10/10/2026 |
| 0.3.2 | 111 | 10/2/2026 |
| 0.3.1 | 99 | 10/2/2026 |
| 0.3.0 | 117 | 9/29/2026 |
| 0.3.0-rc.3 | 78 | 9/27/2026 |
| 0.3.0-rc.2 | 76 | 9/26/2026 |
| 0.3.0-rc.1 | 134 | 6/18/2026 |
| 0.3.0-alpha.3 | 91 | 6/3/2026 |
| 0.3.0-alpha.2 | 121 | 2/21/2026 |
| 0.3.0-alpha.1 | 99 | 2/17/2026 |
| 0.2.1 | 159 | 2/22/2026 |
| 0.2.0 | 154 | 2/8/2026 |
| 0.1.1 | 147 | 1/17/2026 |