Blazorise is a source-available Blazor UI component library for building modern .NET web applications in C#. It provides a consistent, strongly-typed component API across popular CSS frameworks, allowing you to build with Bootstrap 5, Tailwind CSS, Bulma, Material, AntDesign, or Fluent UI 2 without rewriting your application.
Highlights
Provider-agnostic components with multiple CSS framework providers.
C#-first development with a consistent API across providers.
Works in Blazor WebAssembly and Blazor Server apps.
Optional commercial themes, blocks, and priority support.
Blazorise is dual-licensed. Use is governed by the terms in LICENSE.md or a commercial license, depending on your scenario. For teams that need premium assets and support, commercial subscriptions are available.
Dedicated customer support with response times of either 24 or 16 hours, depending on plan.
Priority fixes and feature requests.
* Some features may be exclusive to specific subscription tiers.
Supporting Blazorise
Blazorise is a source-available project, and its ongoing development is made possible through the support of its partners, subscribers, and community contributors.
For full documentation, component API references, and detailed guides, visit the Blazorise official documentation pages.
Continue reading below for a quick start guide.
Installation
Prerequisites
Before you continue, make sure you have a recent .NET SDK and a supported IDE (Visual Studio or VS Code). Visit the official Blazor site to learn more.
Provider packages
There are currently 7 provider packages, one per supported CSS framework.
This guide shows how to set up Blazorise with Bootstrap 5 and FontAwesome 6 icons. To set up Blazorise for other CSS frameworks, refer to the Usage page in the documentation.
1. NuGet packages
Install a provider package and any icon package you want to use. Example for Bootstrap 5 and FontAwesome:
dotnet add package Blazorise.Bootstrap5
And FontAwesome icon package:
dotnet add package Blazorise.Icons.FontAwesome
2. Source files
Add the following to index.html (Blazor WebAssembly), _Host.cshtml (Blazor Server), or App.razor (.NET 8+ Blazor Web App) in the head section.
The ?v=2.0.1.0 query string matches the current Blazorise package version (2.0.1) and is used for cache busting. Update it whenever you upgrade Blazorise packages. If you use a different provider, swap the Bootstrap CSS and provider-specific Blazorise CSS file accordingly.
2.1 JavaScript resources
Blazorise loads any additional JavaScript it needs dynamically once a component needs it. Make sure the resources are available and served relative to the app root. For Blazor Server, enable static files with app.UseStaticFiles();.
If you're having any difficulties, please refer to the following issues:
We are also aware that there might need to be extra setup when dealing with PWA and offline capabilities if you want your app to remain responsive. Please check our PWA docs for more information.
3. Usings
In your main _Imports.razor, add:
@using Blazorise
4. Service registration
Add the following lines to the relevant sections of Program.cs.
using Blazorise;
using Blazorise.Bootstrap5;
using Blazorise.Icons.FontAwesome;
We release a development version of Blazorise on a regular basis. This version is available on the MyGet feed.
This release is not recommended for production use, but it's a great way to test the latest features and bug fixes and give us feedback ahead of the next release.
Contributing
We welcome contributions and any suggestions or feature requests you might have. Contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. This will be signed once you submit a PullRequest on our repository. For details about our CLA, please visit: Contributor License Agreement.
For our code conventions and guidelines please visit: Contributing Guide
