Getting Started
Installation
Add the headless brain, register services, set up the theme, then copy components in with the CLI. Works in any Blazor host: WebAssembly, Server, Blazor Web App, and MAUI Blazor.
- 01
Add the brain
Reference the
Navius.Primitivespackage, the headless engine. The styled components copy in as source; they are not a dependency.Terminal bashdotnet add package Navius.Primitives --prerelease - 02
Register the services
In
Program.cs, register Navius (the portal registry and toast queue).Program.cs csharpbuilder.Services.AddNavius(); - 03
Add the theme
Tailwind plus the OKLCH token theme. In production, build Tailwind v4 with the standalone CLI (no Node). For a quick start the Play CDN works; see Theming.
App.razor html<link href="zits-ui.css" rel="stylesheet" /> - 04
Add a component
The CLI copies a component's source (and its dependencies) into your project and rewrites the namespace.
Terminal bashdotnet tool install -g navius --prerelease navius add button --to ./src/MyApp --namespace MyApp.Ui
That's it: <ZitsButton /> is now yours. Browse the components.