Osirion.Blazor
4.4.2
Prefix Reserved
dotnet add package Osirion.Blazor --version 4.4.2
NuGet\Install-Package Osirion.Blazor -Version 4.4.2
<PackageReference Include="Osirion.Blazor" Version="4.4.2" />
<PackageVersion Include="Osirion.Blazor" Version="4.4.2" />
<PackageReference Include="Osirion.Blazor" />
paket add Osirion.Blazor --version 4.4.2
#r "nuget: Osirion.Blazor, 4.4.2"
#:package Osirion.Blazor@4.4.2
#addin nuget:?package=Osirion.Blazor&version=4.4.2
#tool nuget:?package=Osirion.Blazor&version=4.4.2
Osirion.Blazor
Components, a Markdown CMS and SEO for Blazor Web Apps. Pages render with static server-side rendering and work without JavaScript; where a component loads a script, the script only enhances what the server already rendered.
📦 Packages
Osirion.Blazor brings in every module and the AddOsirion registration method. Each module is also published on
its own.
| Package | What it adds |
|---|---|
| Osirion.Blazor | Every module below, AddOsirion and OsirionSiteLayout |
| Osirion.Blazor.Core | Layout, section, card and form components, the HTML renderer and its sanitizer, cookie consent, email services (README) |
| Osirion.Blazor.Cms | The content management modules, Web and Admin, in one reference (README) |
| Osirion.Blazor.Cms.Web | Content lists, article and page templates, table of contents, SEO metadata and structured data, sitemap and feeds (README) |
| Osirion.Blazor.Cms.Admin | An admin interface that edits content in a GitHub repository (README) |
| Osirion.Blazor.Cms.Core, Domain, Application, Infrastructure | The CMS layers the two modules share: content model, queries, and the file system and GitHub providers |
| Osirion.Blazor.Navigation | Menus, enhanced navigation and scroll to top (README) |
| Osirion.Blazor.Analytics | Trackers for Microsoft Clarity, Google Analytics 4, Matomo, Plausible, Umami and Yandex Metrica (README) |
| Osirion.Blazor.Templates | dotnet new osirion-blog: a Markdown blog served with static server-side rendering (README) |
| Osirion.Blazor.Theming | OsirionStyles, light and dark themes, named palettes, ThemePicker, and adapters for Bootstrap, FluentUI, MudBlazor and Radzen (README) |
🚀 Quick start
The fastest way in is the blog template: three commands to a running Markdown blog with a menu, a footer, light and dark themes, RSS, Atom and a sitemap.
dotnet new install Osirion.Blazor.Templates
dotnet new osirion-blog -n MyBlog
cd MyBlog
dotnet run
To add Osirion to an existing app instead, these steps put a Markdown blog into a new Blazor Web App. The getting started guide covers each step in full, including a GitHub repository as the content source.
dotnet new blazor -n MySite
cd MySite
dotnet add package Osirion.Blazor
Register the services in Program.cs:
using Osirion.Blazor.Extensions;
builder.Services.AddOsirion(builder.Configuration);
AddOsirion(builder.Configuration) reads the Osirion section. Point it at a folder of Markdown files in
appsettings.json:
{
"Osirion": {
"Theming": { "Framework": "Bootstrap" },
"Cms": {
"Web": {
"FileSystem": { "BasePath": "content", "IsDefault": true }
}
}
}
}
Add the namespaces to Components/_Imports.razor and render OsirionStyles once in the layout:
@using Osirion.Blazor.Components
@using Osirion.Blazor.Cms.Components
@using Osirion.Blazor.Cms.Web.Components
@using Osirion.Blazor.Theming.Components
@inherits LayoutComponentBase
@Body
<OsirionStyles />
Then a list page and an article page in one component:
@page "/blog"
@page "/blog/{Slug}"
@if (string.IsNullOrWhiteSpace(Slug))
{
<ContentList Directory="blog" ShowPagination />
}
else
{
<ArticlePage DirectoryName="blog" ItemSlug="@Slug" SchemaTypes="new[] { SchemaType.BlogPosting }" />
}
@code {
[Parameter]
public string? Slug { get; set; }
}
Posts are Markdown files with front matter in content/blog. To serve /sitemap.xml, /feed.xml and /atom.xml,
add app.MapOsirionFeeds(feeds => feeds.SiteUrl = "https://example.com"); after builder.Build().
🆕 What's new in 4.1
- Theming: named palettes (
ThemePalette) with light and dark variants, andThemePickerfor visitors. In the dark theme, the active navigation item and the danger and info messages now reach a 4.5:1 contrast ratio. - Table of contents:
TableOfContentsmarks the section being read as the page scrolls. - Content lists:
ItemTemplateonContentList,ContentListPageandOsirionContentListSectionrenders each item through your own markup;ArticlePage.HeaderContentreplaces the hero. - SEO: the AI, indexing and schema switches in
SeoMetadataOptionsapply unless a page sets them; titles are no longer cut at 60 characters;AuthorUrlnames the author's page in structured data. - Accessibility: code blocks and tables in rendered content can be scrolled from the keyboard.
- Content queries: a category or tag matches by its name or its slug, exactly.
- Last modified dates: a file's write time no longer stands in for
last_modified;FileSystemOptions.UseFileWriteTimeAsLastModifiedrestores the old behaviour.
The changelog lists every change.
📚 Documentation
- Getting started
- Component reference, one page per component
- Analytics, Navigation, GitHub CMS and Styling
- Migration guide
- Examples: the same site built with Bootstrap, FluentUI and MudBlazor
📋 Requirements
- .NET 9 or .NET 10
- A Blazor Web App. Content pages need no interactive render mode; the admin interface runs on Interactive Server.
🤝 Contributing
Contributions are welcome. CONTRIBUTING.md explains how to build, test and measure coverage, and how a release is made. Report bugs and ask questions in issues.
📄 License
MIT. See LICENSE.txt.
🙏 Acknowledgments
- Built with Blazor and ASP.NET Core
- Markdown processing by Markdig
- Testing with bUnit and Shouldly
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
-
net10.0
- AngleSharp (>= 1.8.5)
- Blazored.LocalStorage (>= 4.5.0)
- BlazorJSComponents (>= 1.0.0)
- FluentValidation (>= 12.2.0)
- HtmlSanitizer (>= 9.2.1039)
- Markdig (>= 1.4.1)
- Microsoft.AspNetCore.Components (>= 10.0.14)
- Microsoft.AspNetCore.Components.Web (>= 10.0.14)
- Microsoft.Extensions.Caching.Memory (>= 10.0.14)
- Microsoft.Extensions.Configuration (>= 10.0.14)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection (>= 10.0.14)
- Microsoft.Extensions.Http (>= 10.0.14)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.14)
- Octokit (>= 14.0.0)
- Osirion.Blazor.Analytics (>= 4.4.2)
- Osirion.Blazor.Cms (>= 4.4.2)
- Osirion.Blazor.Core (>= 4.4.2)
- Osirion.Blazor.Navigation (>= 4.4.2)
- Osirion.Blazor.Theming (>= 4.4.2)
- Scrutor (>= 7.0.0)
- System.IO.Abstractions (>= 22.3.0)
- YamlDotNet (>= 18.1.0)
-
net9.0
- AngleSharp (>= 1.8.5)
- Blazored.LocalStorage (>= 4.5.0)
- BlazorJSComponents (>= 1.0.0)
- FluentValidation (>= 12.2.0)
- HtmlSanitizer (>= 9.2.1039)
- Markdig (>= 1.4.1)
- Microsoft.AspNetCore.Components (>= 9.0.21)
- Microsoft.AspNetCore.Components.Web (>= 9.0.21)
- Microsoft.Extensions.Caching.Memory (>= 9.0.21)
- Microsoft.Extensions.Configuration (>= 9.0.21)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.21)
- Microsoft.Extensions.DependencyInjection (>= 9.0.21)
- Microsoft.Extensions.Http (>= 9.0.21)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.21)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.21)
- Octokit (>= 14.0.0)
- Osirion.Blazor.Analytics (>= 4.4.2)
- Osirion.Blazor.Cms (>= 4.4.2)
- Osirion.Blazor.Core (>= 4.4.2)
- Osirion.Blazor.Navigation (>= 4.4.2)
- Osirion.Blazor.Theming (>= 4.4.2)
- Scrutor (>= 7.0.0)
- System.IO.Abstractions (>= 22.3.0)
- YamlDotNet (>= 18.1.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.4.2 | 172 | 10/29/2026 |
| 4.4.1 | 103 | 10/29/2026 |
| 4.4.0 | 108 | 10/29/2026 |
| 4.3.0 | 106 | 10/29/2026 |
| 4.2.0 | 240 | 10/18/2026 |
| 4.1.0 | 194 | 10/17/2026 |
| 4.0.0 | 114 | 10/12/2026 |
| 3.0.1 | 213 | 9/24/2026 |
| 3.0.0 | 151 | 8/5/2026 |
| 2.1.18 | 238 | 12/14/2025 |
| 2.1.17 | 214 | 12/14/2025 |
| 2.1.16 | 211 | 12/14/2025 |
| 2.1.15 | 189 | 12/12/2025 |
| 2.1.14 | 487 | 12/11/2025 |
| 2.1.13 | 487 | 12/11/2025 |
| 2.1.12 | 305 | 9/4/2025 |
| 2.1.11 | 248 | 8/31/2025 |
| 2.1.10 | 300 | 8/29/2025 |
| 2.1.9 | 288 | 8/29/2025 |
| 2.1.8 | 293 | 8/27/2025 |