CLI Tools
Everything you can do with NeoUI from the command line — package management, CSS compilation, the development loop, and what's coming next.
Installing Packages
NeoUI is distributed entirely via NuGet. The primary package includes everything; the others are optional additions.
Styled components (includes Primitives + all icon libraries)
Headless primitives only (when building a custom design system)
Icon libraries (all included transitively with NeoUI.Blazor)
Building Your Project
Standard dotnet commands work as expected.
If you have the Tailwind CSS build integration
configured in your .csproj,
dotnet build automatically
runs npm install and
npm run build:css before compiling.
Build
Run with hot reload
Publish for production
Hot reload and CSS
dotnet watch
triggers a full rebuild (including Tailwind CSS) on each file save. For faster CSS-only
iteration while the app is running, open a second terminal and use
npm run build:css
directly from your Shared project directory.
Tailwind CSS Build
If you have set up the optional Tailwind CSS pipeline (documented in the Theming guide), the following npm commands are available from your Shared project directory:
Install dependencies (first time setup)
Compile and minify CSS
Watch mode — recompile on every CSS file change
The compiled output is written to
wwwroot/css/app.css
and referenced in App.razor
via @Assets[...].
Useful dotnet Commands
A quick reference for common development tasks.
dotnet new install NeoUI.Blazor.Templates
Install the NeoUI project template package from NuGet.dotnet new neoui -n MyApp
Scaffold a new Blazor app pre-wired with NeoUI components.dotnet new list neoui
Verify the NeoUI template is registered.dotnet new uninstall NeoUI.Blazor.Templates
Remove the NeoUI template package.dotnet build
Build the solution. Also triggers npm install + Tailwind CSS compilation if configured.dotnet watch
Run with hot reload. Recompiles and refreshes the browser on file save.dotnet publish -c Release
Publish a production build with optimized assets and fingerprinted URLs.dotnet add package <name>
Add a NuGet package reference to the current project.dotnet restore
Restore NuGet packages without building.dotnet clean
Remove all build output. Useful when CSS or asset changes aren't being picked up.npm install
Install Tailwind CSS devDependencies from package.json (Shared project directory).npm run build:css
Compile and minify Tailwind CSS from app-input.css to app.css.Project Templates
The NeoUI template package scaffolds a complete Blazor Web App — sidebar layout, theme switcher,
dark mode toggle, Spotlight command palette, and Tailwind CSS v4 — in a single command.
Supports Server,
WebAssembly, and
Auto interactivity modes.
Install the template package (once)
Scaffold a new app
Verify the template is registered
Uninstall
For all template options (--interactivity,
--empty, port randomization, and more)
see the Project Template docs.