ShellUI.CLI 0.4.0-alpha.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.4.0-alpha.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.4.0-alpha.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=ShellUI.CLI&version=0.4.0-alpha.1&prerelease
                    
nuke :add-package ShellUI.CLI --version 0.4.0-alpha.1
                    

ShellUI CLI

shellui sets up Tailwind CSS in a Blazor project and copies ShellUI components into it as source you own, in the spirit of shadcn/ui.

Install

The tool needs the .NET 10 runtime. The projects it sets up can target .NET 8, 9 or 10:

dotnet tool install --global ShellUI.CLI

Or as a local tool, invoked as dotnet shellui:

dotnet new tool-manifest
dotnet tool install --local ShellUI.CLI

Quick start

From the root of a Blazor project:

shellui init
shellui add button card dialog
dotnet watch

init sets up Tailwind CSS 4.3.2 (the standalone executable, or npm), writes the default theme to wwwroot/input.css, adds a build step that compiles it to wwwroot/app.css, and patches App.razor with an interactive render mode, a theme script, and shellui.js. It removes the template's local Bootstrap copy and its <link>, and restyles the template's sample pages if you haven't edited them.

add writes each component and everything it depends on to Components/UI/. It also adds the NuGet packages, stylesheet links, and _Imports.razor usings the components need.

Commands

Command Purpose
init Set up ShellUI and Tailwind in the current project
add <names...> Install components and their dependencies
list List the 93 components, with --installed or --available filters
remove <names...> Delete installed component files
update [names...] Rewrite installed components from the current templates (--all for every one)
theme init <url-or-id> Run init, then apply a tweakcn theme
theme apply <url-or-id> Apply a tweakcn theme to wwwroot/input.css, or write an override file with --emit-override <path>
theme update Re-apply the theme recorded in shellui.theme.lock

init options:

  • --tailwind standalone|npm selects how Tailwind is installed. standalone needs no Node.js. npm mode runs npm through cmd, so it only works on Windows.
  • --yes runs without prompts; Tailwind defaults to standalone.
  • --force re-initializes a project that already has shellui.json.
  • --dashboard 02|01|none sets up a dashboard layout (sticky or scrolling header) and makes it the default layout. Without the option, init asks; --yes alone means none.
  • --replace-layout switches to the dashboard even when the app has a custom layout.
  • --style is recorded in shellui.json. All styles currently install the same templates.

add accepts names separated by spaces or commas, and --force overwrites existing files. update and add --force overwrite your copies, so commit customized components first. add dashboard-01 or add dashboard-02 also makes the dashboard the default layout and builds its sidebar links from your pages. remove does not handle dashboard layouts; delete those from Components/Layout/ yourself.

Generated files

Path Purpose
Components/UI/ Installed components
Components/Layout/ Dashboard layouts, when installed
wwwroot/input.css Tailwind input and theme variables
wwwroot/app.css Compiled CSS
wwwroot/shellui.js JavaScript used by some components
Build/ShellUI.targets Tailwind build step
shellui.json ShellUI settings and installed components
shellui.theme.lock Theme source, when a theme is applied

Documentation

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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