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
                    
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="Osirion.Blazor" Version="4.4.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Osirion.Blazor" Version="4.4.2" />
                    
Directory.Packages.props
<PackageReference Include="Osirion.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 Osirion.Blazor --version 4.4.2
                    
#r "nuget: Osirion.Blazor, 4.4.2"
                    
#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 Osirion.Blazor@4.4.2
                    
#: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=Osirion.Blazor&version=4.4.2
                    
Install as a Cake Addin
#tool nuget:?package=Osirion.Blazor&version=4.4.2
                    
Install as a Cake Tool

Osirion.Blazor

NuGet CI License Security Rating codecov

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, and ThemePicker for 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: TableOfContents marks the section being read as the page scrolls.
  • Content lists: ItemTemplate on ContentList, ContentListPage and OsirionContentListSection renders each item through your own markup; ArticlePage.HeaderContent replaces the hero.
  • SEO: the AI, indexing and schema switches in SeoMetadataOptions apply unless a page sets them; titles are no longer cut at 60 characters; AuthorUrl names 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.UseFileWriteTimeAsLastModified restores the old behaviour.

The changelog lists every change.

📚 Documentation

📋 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

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed