CymruBlazor 2.2.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package CymruBlazor --version 2.2.0
                    


                    

                
NuGet\Install-Package CymruBlazor -Version 2.2.0
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="CymruBlazor" Version="2.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CymruBlazor" Version="2.2.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CymruBlazor" />
                    


                            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 CymruBlazor --version 2.2.0
                    


                    

                
#r "nuget: CymruBlazor, 2.2.0"
#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 CymruBlazor@2.2.0
#: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=CymruBlazor&version=2.2.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CymruBlazor&version=2.2.0
                    


                            Install as a Cake Tool

CymruBlazor

An open-source Blazor component library implementing the NHS Wales Design System.

NuGet NuGet Downloads CI License: MIT

Status: Stable (2.x)

CymruBlazor follows Semantic Versioning: new components and features arrive in minor releases, and breaking changes are reserved for major releases. Upgrading from 1.x? See the v2.0.0 Migration Guide. See the CHANGELOG for release history.

Getting Started

Targets .NET 10. Install the package from NuGet:

dotnet add package CymruBlazor

Add the stylesheet to your App.razor (Blazor Web App) or wwwroot/index.html (Blazor WebAssembly):

<link href="_content/CymruBlazor/css/cymrublazor.css" rel="stylesheet" />

Register CymruBlazor services in Program.cs:

builder.Services.AddCymruBlazor();

See the Scaffold Guide for a step-by-step setup walkthrough, and the Demo application for live usage.

Testing Packages

CymruBlazor provides dedicated testing packages to test your own applications with the same checks the library uses on itself:

dotnet add package CymruBlazor.Testing        # bUnit helpers and structural markup checks
dotnet add package CymruBlazor.Testing.Axe    # Playwright and axe-core browser accessibility scans
  • CymruBlazor.Testing: Provides CymruTestContext for bUnit tests and CymruMarkupChecks for verifying form control labeling, ARIA references, and heading hierarchy without needing a browser.
  • CymruBlazor.Testing.Axe: Provides CymruAxeTestBase for automated WCAG accessibility scans against Chromium in light, dark, and high-contrast themes.

See the Testing Guide for complete details and examples.

Documentation

The full component catalogue, with live previews and code samples, is published from the Demo application to GitHub Pages:

gncube.github.io/CymruBlazor

Additional guides:

  • v2.0.0 Migration Guide - Upgrading from 1.x to 2.0.0.
  • Scaffold Guide - Project setup, configuration, and architectural guidance.
  • Testing Guide - Component tests with bUnit and browser-based accessibility scans with axe-core.
  • Recipes - Common page templates, layouts, and Welsh localisation examples.
  • Diagnostics - Compiler warnings and runtime diagnostic codes.

Contributing

Read CONTRIBUTING.md before opening a pull request.

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 CymruBlazor:

Package Downloads
CymruBlazor.Testing

bUnit helpers for testing apps built with CymruBlazor: a test context with the library registered, and markup checks for ids, ARIA references, accessible names and heading levels. No browser needed.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.2.0 0 10/20/2026
2.1.0 0 10/20/2026
2.0.1 51 10/19/2026
2.0.0 106 10/14/2026
1.13.0 136 10/12/2026
1.12.3 140 10/9/2026
1.12.2 83 10/9/2026
1.12.0 91 10/7/2026
1.11.0 140 10/7/2026
1.10.0 122 10/6/2026
1.9.0 96 10/5/2026
1.8.0 125 10/3/2026
1.7.0 115 10/3/2026
1.6.0 171 9/28/2026
1.5.2 86 9/27/2026
1.5.1 102 9/26/2026
1.5.0 155 9/24/2026
1.4.0 107 9/23/2026
1.3.0 107 9/21/2026
1.2.1 109 9/19/2026
Loading failed