AndersonN.Omni.Blazor.Mcp 0.12.0

dotnet tool install --global AndersonN.Omni.Blazor.Mcp --version 0.12.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local AndersonN.Omni.Blazor.Mcp --version 0.12.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=AndersonN.Omni.Blazor.Mcp&version=0.12.0
                    
nuke :add-package AndersonN.Omni.Blazor.Mcp --version 0.12.0
                    

Omni.Blazor

NuGet Downloads License: MIT .NET CI GitHub Pages

Explore the live component showcase

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

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

Highlights

  • 210 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
  • Reusable typed i18n pipeline — the UI-independent AndersonN.Omni.Localization core plus optional JSON/PO packages can localize any .NET application; Omni.Blazor contributes isolated pt-BR/English component resources, real plural rules, global/scoped cultures, RTL and pseudo-locales (guide)
  • 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

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

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

OmniAppBar, OmniAppearanceToggle, OmniAuthLayout, OmniBanner, OmniBento, OmniBentoItem, OmniBrand, OmniBreakpointProvider, OmniCol, OmniContainer, OmniCulturePicker, OmniCultureScope, 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> (34)</summary>

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

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

OmniCompareValidator, OmniCustomValidator, OmniDataAnnotationValidator, OmniDataForm, OmniDataFormWizard, OmniEmailValidator, OmniForm, OmniLengthValidator, OmniPropertyGrid, 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> (39)</summary>

OmniChat, OmniDataFilter, OmniDataFilterItem, OmniDataGrid, OmniDataGridColumn, OmniDataGridForm, OmniDataImport, OmniDayView, OmniDiagramCanvas, OmniDropZone, OmniDropZoneContainer, OmniDropZoneItem, OmniFileManager, OmniGantt, OmniGanttColumn, OmniGanttForm, OmniHtmlEditor, OmniHtmlEditorButton, OmniKanban, OmniKanbanForm, OmniMonthView, OmniMultiDayView, OmniPivotColumn, OmniPivotGrid, OmniPivotRow, OmniPivotValue, OmniScheduler, OmniSchedulerForm, OmniTree, OmniTreeGrid, OmniTreeGridColumn, OmniTreeItem, OmniTreeLevel, OmniVirtualize, OmniWeekView, OmniWorkflowDesigner, 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:

  • building-omni-blazor-apps Agent Skill — portable, progressively disclosed guidance for choosing components, composing application screens, matching the catalog version, and validating generated UI. See the step-by-step manual installation guide for ChatGPT Desktop/Codex, Claude Code, and GitHub Copilot, at project or personal scope.
  • 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 get_catalog_info, component discovery, and typed configuration API 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. Call get_catalog_info first and match it to the resolved NuGet package. Setup, scopes and troubleshooting: AGENTS.md.

The skill follows the open Agent Skills specification. ChatGPT Desktop/Codex and Copilot discover manual installations from .agents/skills/; Claude Code uses .claude/skills/. The installation guide includes copy commands, verification, updates, new-project setup, and the ChatGPT web/mobile limitation. MCP is recommended for focused live queries, but the skill also works with version-matched generated files.

All three files are also served from the showcase site, if you would rather fetch them than install anything — they track main, so do not use them for an older package:

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. For usage help, see SUPPORT.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.

This package has no dependencies.

Version Downloads Last Updated
0.12.0 195 9/8/2026
0.11.3 147 8/28/2026
0.11.2 129 8/28/2026
0.11.1 131 8/27/2026
0.10.0 140 8/21/2026
0.9.0 145 8/15/2026
0.8.0 145 8/13/2026
0.7.0 143 8/10/2026
0.6.1 138 8/9/2026
0.6.0 132 8/7/2026
0.5.0 144 8/2/2026
0.4.0 159 8/1/2026
0.3.0 159 6/27/2026