ShellUI.CLI 0.3.0-rc.2

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

ShellUI CLI

The ShellUI command-line tool initializes a .NET 10 Blazor project and copies ShellUI component templates into source files that the application owns.

Install

The tool needs the .NET 10 runtime. Prereleases are not picked up by a plain install, so pass the version:

dotnet tool install --global ShellUI.CLI --version 0.3.0-rc.2

A global tool uses the shellui command:

shellui --help

A local .NET tool uses dotnet shellui:

dotnet new tool-manifest
dotnet tool install --local ShellUI.CLI --version 0.3.0-rc.2
dotnet shellui --help

Quick start

Run these commands from the root of the target Blazor project:

shellui init
shellui add button card dialog
shellui list
shellui list --installed

For a local tool, prefix each command with dotnet , for example dotnet shellui init.

init detects the Blazor project, creates the ShellUI folder and configuration structure, selects the Tailwind method, writes the default theme, wires the host, and adds the Tailwind MSBuild integration. It can use the standalone Tailwind executable or npm.

Commands

init

Initialize ShellUI in a Blazor project.

shellui init

Options:

  • --force reinitialize a project that is already configured
  • --style <default|new-york|minimal> select a component style
  • --tailwind <standalone|npm> select the Tailwind build method
  • --yes accept the defaults without prompts

add <components...>

Install one or more direct component targets and their dependencies.

shellui add button
shellui add input card dialog table
shellui add button,input,card

Options:

  • --force overwrite existing files

Dependency-only registry entries are hidden from list but are installed recursively. Some templates also add required NuGet packages and stylesheet links.

list

List direct component targets.

shellui list
shellui list --installed
shellui list --available

remove <components...>

Remove one or more named installed components.

shellui remove button input

The command accepts one or more component names. Review local changes before removing source files. Layout blocks such as dashboard-01 and dashboard-02 currently require manual removal from Components/Layout because remove is not yet layout-aware.

update [components...]

Reinstall named components from the current CLI templates. With no names, or with --all, it updates every installed component.

shellui update button
shellui update card input
shellui update --all

update overwrites template files. Commit or otherwise preserve local customizations before running it.

theme init <url-or-id>

Initialize a project and apply a public tweakcn theme in one operation.

shellui theme init https://tweakcn.com/themes/THEME_ID
shellui theme init THEME_ID --yes

The URL argument also accepts a bare theme ID or a public https://tweakcn.com/r/themes/THEME_ID URL. Options match init: --force, --style, --tailwind, and --yes.

theme apply <url-or-id>

Apply a theme to an initialized project.

shellui theme apply https://tweakcn.com/themes/THEME_ID
shellui theme apply THEME_ID --emit-override wwwroot/theme.css

Without --emit-override, the command replaces the sentinel-marked region in wwwroot/input.css and leaves surrounding CSS intact. With --emit-override, it writes a standalone theme file that can be loaded after shellui-all.css.

theme update

Re-fetch the theme recorded in shellui.theme.lock and apply it again.

shellui theme update

The lock file stores the original source URL, theme name, timestamp, and SHA-256 of the fetched theme JSON.

Component inventory

The registry contains 176 entries:

  • 76 direct install targets, shown by list
  • 100 hidden dependency entries, resolved by add but omitted from the direct list

The targets added in 0.3.0-rc.2 are:

shellui add typed-select command-palette data-picker multi-select tag-input donut-chart radar-chart radial-chart

Use shellui list for the complete direct-target inventory and descriptions.

Generated project structure

A typical initialized project contains:

Path Purpose
Components/UI/ Installed component source
Components/Layout/ Dashboard layout blocks, when installed
wwwroot/input.css Tailwind input and ShellUI theme variables
wwwroot/app.css Compiled project CSS
wwwroot/shellui.js JavaScript interop used by ShellUI components
Build/ShellUI.targets MSBuild Tailwind integration
shellui.json Installed component and Tailwind configuration
shellui.theme.lock Theme source metadata, when a theme is applied

Tailwind setup

ShellUI uses Tailwind CSS 4.3.2.

  • shellui init --tailwind standalone downloads the standalone executable and does not require Node.js.
  • shellui init --tailwind npm --yes installs tailwindcss@^4.3.2 and @tailwindcss/cli@^4.3.2 and requires Node.js and npm.

Both methods compile wwwroot/input.css to wwwroot/app.css through the generated MSBuild target. The current CLI invokes npm through cmd; use standalone mode on non-Windows systems or run npm manually.

Development

From the repository root:

dotnet restore ShellUI.slnx
dotnet build ShellUI.slnx
dotnet test ShellUI.slnx

The CLI project is src/ShellUI.CLI/ShellUI.CLI.csproj. ShellUI.Core and ShellUI.Templates are internal dependencies and are not packable.

Documentation

The release notes are historical records for published versions and do not replace this source-version command reference.

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