ShellUI.CLI
0.3.0-rc.2
See the version list below for details.
dotnet tool install --global ShellUI.CLI --version 0.3.0-rc.2
dotnet new tool-manifest
dotnet tool install --local ShellUI.CLI --version 0.3.0-rc.2
#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:
--forcereinitialize a project that is already configured--style <default|new-york|minimal>select a component style--tailwind <standalone|npm>select the Tailwind build method--yesaccept 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:
--forceoverwrite 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
addbut 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 standalonedownloads the standalone executable and does not require Node.js.shellui init --tailwind npm --yesinstallstailwindcss@^4.3.2and@tailwindcss/cli@^4.3.2and 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
| Product | Versions 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. |
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 |