ShellUI.CLI 0.3.0-rc.1

This is a prerelease version of ShellUI.CLI.
There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global ShellUI.CLI --version 0.3.0-rc.1
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local ShellUI.CLI --version 0.3.0-rc.1
                    
This package contains a .NET tool you can call from the shell/command line.
#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) to wwwroot/input.css
  • ✅ Patches Components/App.razor with @rendermode="InteractiveServer", a theme-bootstrap <script> (no light-flash on dark pages), and the <script src="shellui.js"> tag
  • ✅ Patches wwwroot/index.html instead 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
  • 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:

  1. Run dotnet shellui init if you haven't already
  2. Check that tailwind.config.js exists
  3. Verify wwwroot/input.css contains @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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed