AndersonN.Omni.Blazor 0.6.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package AndersonN.Omni.Blazor --version 0.6.1
                    


                    

                
NuGet\Install-Package AndersonN.Omni.Blazor -Version 0.6.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="AndersonN.Omni.Blazor" Version="0.6.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="AndersonN.Omni.Blazor" Version="0.6.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="AndersonN.Omni.Blazor" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add AndersonN.Omni.Blazor --version 0.6.1
                    


                    

                
#r "nuget: AndersonN.Omni.Blazor, 0.6.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package AndersonN.Omni.Blazor@0.6.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=AndersonN.Omni.Blazor&version=0.6.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=AndersonN.Omni.Blazor&version=0.6.1
                    


                            Install as a Cake Tool

Omni.Blazor

NuGet Downloads License: MIT .NET CI GitHub Pages

Explore the live component showcase

Modern Blazor component library for .NET 10 — 206 components, warm cream/amber design system, dark mode, runtime accent swap, no Bootstrap dependency.

<PackageReference Include="AndersonN.Omni.Blazor" Version="*" />

Highlights

  • 206 components across data, inputs, layout, navigation, overlays, marketing, and AI/chat
  • Single CSS bundle (~295 KB) — no Bootstrap, no Tailwind, no runtime CSS-in-JS
  • Design tokens in CSS custom properties (--omni-*) — restyleable without recompiling
  • Light / Dark / System appearance toggle out of the box
  • Runtime accent swap — 12 accessible palettes via [data-accent]
  • Cream + amber default palette (Forneria design language)
  • Source Link + portable PDBs + .snupkg — step into the library while debugging
  • Static Web Assets — CSS plus independently lazy-loaded JS feature modules; no manual <script> tag
  • Native AOT + trimming — package analyzers are enabled and a published native consumer is exercised in CI
  • AI-ready — llms.txt + llms-full.txt + a machine-readable docs/components.json manifest and an AGENTS.md runbook, so coding agents (Claude Code, Cursor, Copilot) generate correct code
  • Typed data workflows — reusable Fluent schemas for DataGrid, Gantt, Scheduler, Kanban, Chart and Diagram, plus metadata-driven DataForm, CRUD DataGridForm, import, wizard and a serializable DataFilter query builder
  • MIT licensed

Installation

dotnet add package AndersonN.Omni.Blazor

Or via NuGet UI in Visual Studio / Rider.

Optional — AI layer

The AI orchestration (OmniChatClient + the drop-in OmniAiConversation, built on the standard Microsoft.Extensions.AI.IChatClient) ships as a separate package so the base library never forces the AI dependency on consumers who don't use it:

dotnet add package AndersonN.Omni.Blazor.Ai

It references the base package, so installing it pulls in AndersonN.Omni.Blazor too. The streaming-UI primitives (OmniStreamingText, OmniMessage, OmniPromptInput, …) stay in the base package — only the IChatClient-backed orchestration lives in .Ai.

Security — keep model credentials server-side. In a Blazor WebAssembly app, never configure the IChatClient with a provider API key on the client (it ships to the browser). Point the client at a server-side proxy / your own backend endpoint that holds the key. In Blazor Server the key already lives on the server.

Quick start

1) Reference the stylesheet (handled automatically — <OmniTheme> injects it):

@* App.razor / _Host.cshtml *@
<head>
    <OmniTheme />
</head>

2) Wrap your shell with the layout primitives (MainLayout.razor):

@inherits LayoutComponentBase

<OmniLayout>
    <OmniAppBar>
        <OmniDrawerToggle Target="_drawer" />
        <OmniBrand Name="Acme" />
        <div class="omni-header-spacer"></div>
        <OmniAppearanceToggle />
    </OmniAppBar>

    <OmniDrawer @ref="_drawer" Anchor="DrawerAnchor.Left">
        <OmniPanelMenuSection Label="Main">
            <OmniPanelMenuItem Text="Dashboard" Icon="layout-dashboard" Path="/" />
            <OmniPanelMenuItem Text="Orders"    Icon="package"          Path="/orders" />
        </OmniPanelMenuSection>
    </OmniDrawer>

    <OmniMain>
        @Body
    </OmniMain>
</OmniLayout>

@* Renders dialogs, notifications, tooltips and context menus opened via the services. *@
<OmniOverlayHosts />

@code {
    private OmniDrawer _drawer = null!;
}

3) Use components anywhere:

<OmniDataGrid TItem="Order" Data="@orders" AllowPaging PageSize="20" AllowSorting AllowColumnFilter>
    <Columns>
        <OmniDataGridColumn TItem="Order" Title="#" Property="@(o => (object)o.Id)" />
        <OmniDataGridColumn TItem="Order" Title="Total" Property="@(o => (object)o.Total)">
            <Template>
                <span class="omni-mono">@context.Total.ToString("C")</span>
            </Template>
        </OmniDataGridColumn>
        <OmniDataGridColumn TItem="Order" Title="Status" Property="@(o => o.Status)">
            <Template>
                <OmniBadge Text="@context.Status" Variant="BadgeVariant.Accent" />
            </Template>
        </OmniDataGridColumn>
    </Columns>
</OmniDataGrid>

For reusable, refactor-safe configuration, move the structural API to an immutable schema:

<OmniDataGrid TItem="Order" Data="@orders" Schema="@OrderGrid" />

@code {
    private static readonly DataGridSchema<Order> OrderGrid =
        DataGridSchema<Order>.Create(grid => grid
            .Key(order => order.Id)
            .Column(order => order.Id, column => column.Title("#").Width("90px"))
            .Column(order => order.Total, column => column.Title("Total").Format("C2"))
            .Column(order => order.Status, column => column.Filterable())
            .Search()
            .ColumnResize()
            .Paging(20));
}

The same DataGridSchema<TItem> can configure OmniDataGridForm and the embedded grid in OmniEntityPicker.

Native AOT and trimming

Omni.Blazor declares IsAotCompatible and treats trim/AOT diagnostics as build errors. For Native AOT consumers, declare reflection-sensitive workflows with the typed schemas and disable DataForm auto-generation:

DataFormSchema<Contact> schema = DataFormSchema<Contact>.Create(form => form
    .AutoGenerateFields(false)
    .Field(contact => contact.Name)
    .Field(contact => contact.Email));

OmniDataImport also requires an explicit .Factory(...). Runtime DataForm field generation remains available to JIT applications, but intentionally fails with an actionable message when dynamic code isn't supported.

Component catalog

206 components — generated from docs/components.json. Run dotnet run --project tools/Omni.Blazor.ManifestGen after changing the public surface.

<details> <summary><strong>Layout</strong> (32)</summary>

OmniAppBar, OmniAppearanceToggle, OmniAuthLayout, OmniBanner, OmniBento, OmniBentoItem, OmniBrand, OmniBreakpointProvider, OmniCol, OmniContainer, OmniDrawer, OmniDrawerToggle, OmniFooter, OmniHidden, OmniLayout, OmniMain, OmniMasonry, OmniMediaQuery, OmniPaneHeader, OmniPaneToolbar, OmniParallax, OmniParallaxLayer, OmniRow, OmniSplitAsideLabel, OmniSplitView, OmniSplitter, OmniSplitterPane, OmniStack, OmniSwipeArea, OmniTheme, OmniThemePicker, OmniToolBar </details>

<details> <summary><strong>Navigation</strong> (15)</summary>

OmniBreadcrumb, OmniExitPrompt, OmniGlobalSearch, OmniHotkey, OmniMenuBar, OmniMenuBarItem, OmniPagination, OmniPanelMenu, OmniPanelMenuItem, OmniPanelMenuSection, OmniSegmentedControl, OmniStep, OmniStepper, OmniTabItem, OmniTabs </details>

<details> <summary><strong>Inputs</strong> (32)</summary>

OmniAutoComplete, OmniCalendar, OmniCheckBox, OmniCheckBoxList, OmniColorPicker, OmniDatePicker, OmniDateRangePicker, OmniEntityPicker, OmniFileUpload, OmniFormField, OmniListBox, OmniMaskedTextBox, OmniMultiSelect, OmniNumeric, OmniPassword, OmniPasswordStrength, OmniPickList, OmniQtyStepper, OmniRadio, OmniRadioGroup, OmniRating, OmniSecurityCode, OmniSelect, OmniSignaturePad, OmniSlider, OmniSpeechToText, OmniSpeechToTextButton, OmniSwitch, OmniTagInput, OmniTextArea, OmniTextBox, OmniTimePicker </details>

<details> <summary><strong>Forms</strong> (13)</summary>

OmniCompareValidator, OmniCustomValidator, OmniDataAnnotationValidator, OmniDataForm, OmniDataFormWizard, OmniEmailValidator, OmniForm, OmniLengthValidator, OmniRangeValidator, OmniRegexValidator, OmniRequiredValidator, OmniValidationMessage, OmniValidationSummary </details>

<details> <summary><strong>Buttons</strong> (8)</summary>

OmniButton, OmniFab, OmniFabMenu, OmniFabMenuItem, OmniScrollToTopButton, OmniSocialButton, OmniSplitButton, OmniToggleButton </details>

<details> <summary><strong>Display</strong> (37)</summary>

OmniAccordion, OmniAccordionItem, OmniAlert, OmniAvatar, OmniAvatarGroup, OmniBadge, OmniBarcode, OmniCard, OmniCardBody, OmniCardGroup, OmniCardMedia, OmniCarousel, OmniCarouselItem, OmniChart, OmniChip, OmniDescriptionItem, OmniDescriptionList, OmniEmptyState, OmniIcon, OmniImage, OmniKbd, OmniLabel, OmniLink, OmniMarkdown, OmniOptionCard, OmniProgress, OmniProgressCircular, OmniQRCode, OmniResult, OmniSkeleton, OmniSparkline, OmniSpinner, OmniStat, OmniStatGroup, OmniStatusBadge, OmniTimeline, OmniTimelineItem </details>

<details> <summary><strong>Data</strong> (36)</summary>

OmniChat, OmniDataFilter, OmniDataFilterItem, OmniDataGrid, OmniDataGridColumn, OmniDataGridForm, OmniDataImport, OmniDayView, OmniDiagramCanvas, OmniDropZone, OmniDropZoneContainer, OmniDropZoneItem, OmniFileManager, OmniGantt, OmniGanttColumn, OmniHtmlEditor, OmniHtmlEditorButton, OmniKanban, OmniMonthView, OmniMultiDayView, OmniPivotColumn, OmniPivotGrid, OmniPivotRow, OmniPivotValue, OmniScheduler, OmniTree, OmniTreeGrid, OmniTreeGridColumn, OmniTreeItem, OmniTreeLevel, OmniVirtualize, OmniWeekView, OmniYearPlannerView, OmniYearTimelineView, OmniYearView </details>

<details> <summary><strong>Overlays & feedback</strong> (18)</summary>

AlertDialog, ConfirmDialog, OmniBottomSheet, OmniCommandPalette, OmniConfirmPrompt, OmniContextMenuHost, OmniDialogHost, OmniMenu, OmniMenuItem, OmniMenuSeparator, OmniNotificationHost, OmniOverlay, OmniOverlayHosts, OmniPopover, OmniTooltipHost, OmniTour, OmniTourHost, OmniTourStep </details>

<details> <summary><strong>Marketing</strong> (4)</summary>

OmniEyebrow, OmniHero, OmniMosaic, OmniMosaicCard </details>

<details> <summary><strong>AI & chat</strong> (7)</summary>

OmniAiConversation, OmniCitation, OmniMessage, OmniPromptInput, OmniStreamingText, OmniSuggestionChips, OmniThinkingBlock </details>

Page templates

Beyond the components, the repo ships 26 ready-made pages — login, register, 2FA, users grid, roles, permissions, dashboard, pricing, error states, and the app shell (top bar + collapsible sidebar + content) that every app needs.

They are copy-paste starters, not a package: run the gallery, hit "Ver código", paste into your project. The copyable markup only uses components plus CSS classes that ship in omni.css, so it works as-is in your app (enforced in CI).

dotnet run --project src/Omni.Templates/Omni.Templates.Host   # http://localhost:5305

→ Template index and usage

For AI agents

Coding agents (Claude Code, Cursor, Copilot, v0) should read the generated, machine-readable surface instead of browsing component source:

  • llms.txt — curated index of every component (name, category, one-line description, source link).
  • llms-full.txt — full dump: parameters, events, slots, enum values and theme tokens.
  • docs/components.json — the same data, structured (generated by tools/Omni.Blazor.ManifestGen).
  • AGENTS.md — runbook for using the library and contributing components. Cursor (.cursor/rules/) and Copilot (.github/copilot-instructions.md) rules point here.
  • MCP server — live list_components / get_component / search_components tools over the manifest. Install with dotnet tool install -g AndersonN.Omni.Blazor.Mcp (already installed? dotnet tool update -g — the manifest is baked in, so an old tool serves an old catalog), then register it with claude mcp add omni-blazor --scope user -- omni-blazor-mcp or the equivalent mcpServers entry. Setup, scopes and troubleshooting: AGENTS.md.

All three files are also served from the showcase site, if you would rather fetch them than install anything — they track main:

If a parameter is not in docs/components.json, it does not exist — don't invent it.

Theming

All visual tokens are CSS custom properties:

:root {
  --omni-bg:           oklch(0.985 0.004 60);
  --omni-fg:           oklch(0.18 0.01 60);
  --omni-accent:       #d97706;  /* amber by default */
  --omni-accent-hover: #f59e0b;
  --omni-radius:       10px;
  /* ...80+ tokens; see Themes/_tokens.scss */
}

Swap accents at runtime:

<html data-accent="emerald">

Or set dark mode:

<html data-theme="dark">

The <OmniAppearanceToggle /> component does both, persists to localStorage, and respects prefers-color-scheme.

Supported targets

Framework Status
.NET 10 (Blazor Server) ✅ Primary target
.NET 10 (Blazor WebAssembly) ✅ Supported
.NET 10 (Blazor United / hybrid) ✅ Supported

Examples

The repository ships two reference apps:

  • src/Forneria.Demo — the default component showcase, with an animated product landing, searchable catalog and Server/WASM hosts.
  • src/FoodService — an independent vertical sample with its own landing, operational POS and customer-facing digital menu.

To run locally:

git clone https://github.com/afernandes/Omni.Blazor.git
cd Omni.Blazor
dotnet run --project src/Forneria.Demo/Forneria.Demo

Open http://localhost:5253.

Contributing

Bug reports, feature requests and PRs are welcome — see CONTRIBUTING.md and CODE_OF_CONDUCT.md. Vulnerability reports follow SECURITY.md.

Versioning

Releases follow Semantic Versioning. The changelog lives at CHANGELOG.md and is authored in the Keep a Changelog format.

License

Released under the MIT License. The bundled CSS reset is forked from Bootstrap 5 (MIT) — credit kept in Themes/_reset.scss.

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.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on AndersonN.Omni.Blazor:

Package Downloads
AndersonN.Omni.Blazor.Ai

Optional AI layer for Omni.Blazor — a headless OmniChatClient orchestrator and a drop-in OmniAiConversation component over the standard Microsoft.Extensions.AI IChatClient (any provider: OpenAI, Azure, Ollama, …). Streaming, history, system prompt; zero provider lock-in.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.6.1 0 8/9/2026
0.6.0 42 8/7/2026
0.5.0 197 8/2/2026
0.4.0 116 8/1/2026
0.3.0 152 6/27/2026
0.2.0 139 6/18/2026