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.

  1. 01

    Add the brain

    Reference the Navius.Primitives package, the headless engine. The styled components copy in as source; they are not a dependency.

    Terminal bash
    dotnet add package Navius.Primitives --prerelease
  2. 02

    Register the services

    In Program.cs, register Navius (the portal registry and toast queue).

    Program.cs csharp
    builder.Services.AddNavius();
  3. 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" />
  4. 04

    Add a component

    The CLI copies a component's source (and its dependencies) into your project and rewrites the namespace.

    Terminal bash
    dotnet tool install -g navius --prerelease
    navius add button --to ./src/MyApp --namespace MyApp.Ui

That's it: <ZitsButton /> is now yours. Browse the components.