MudBlazor 8.6.0
Prefix Reserveddotnet add package MudBlazor --version 8.6.0
NuGet\Install-Package MudBlazor -Version 8.6.0
<PackageReference Include="MudBlazor" Version="8.6.0" />
<PackageVersion Include="MudBlazor" Version="8.6.0" />
<PackageReference Include="MudBlazor" />
paket add MudBlazor --version 8.6.0
#r "nuget: MudBlazor, 8.6.0"
#addin nuget:?package=MudBlazor&version=8.6.0
#tool nuget:?package=MudBlazor&version=8.6.0
<h1> <picture> <source media="(prefers-color-scheme: dark)" srcset="content/MudBlazor-GitHub-NoBg-Dark.png"> <source media="(prefers-color-scheme: light)" srcset="content/MudBlazor-GitHub-NoBg.png"> <img alt="MudBlazor" src="content/MudBlazor-GitHub-NoBg.png"> </picture> </h1>
Material Design components for Blazor
MudBlazor is an ambitious Material Design component framework for Blazor with an emphasis on ease of use and clear structure. It is perfect for .NET developers who want to rapidly build web applications without having to struggle with CSS and Javascript. MudBlazor, being written entirely in C#, empowers you to adapt, fix or extend the framework. There are plenty of examples in the documentation, which makes understanding and learning MudBlazor very easy.
📘 Documentation & Demo
- 🌐 MudBlazor.com – Full documentation
- ⚡ Try.MudBlazor.com – Interactive playground
💎 Why is MudBlazor so successful?
- Aesthetic design that follows Material Design principles.
- Intuitive, consistent component structure.
- Rich documentation with tons of examples and code snippets.
- Fully written in C# with minimal JavaScript.
- Build beautiful UIs without CSS (but fully customizable when needed).
- No third-party component dependencies – maximum flexibility.
- Strive for stability with extensive test coverage.
- Frequent releases so devs get their fixes and features fast.
⚙️ Prerequisites
MudBlazor | .NET | Support |
---|---|---|
1.x.x - 2.0.x | .NET 3.1 | Ended 03/2021 |
5.x.x | .NET 5 | Ended 01/2022 |
6.x.x | .NET 6, .NET 7, .NET 8 | Ended 01/2025 |
7.x.x | .NET 7, .NET 8 | Limited |
8.x.x | .NET 8, .NET 9 | ✔️ |
[!TIP] Upgrading? Check our Migration Guide for help with breaking changes.
[!WARNING]
- Static rendering is not supported - Learn more.
- Older browsers may not be supported. Use a modern, up-to-date browser - Blazor supported platforms.
📊 Repo Stats
🤝 Contributing
Thanks for wanting to contribute! 👋
Contributions from the community are what makes MudBlazor successful.
If you're comfortable with C#, Blazor, JavaScript, or CSS, we'd love your help!
Whether it's fixing bugs, adding features, or improving documentation, every contribution counts.
We aim to review and merge non-breaking pull requests quickly.
For larger features or changes, feel free to chat with us on Discord first to get feedback before diving in.
📚 Check out our contribution guidelines to get started and learn more about how the project works.
🚀 Getting Started
We have ready-to-go templates at the MudBlazor.Templates repository, or follow the quick install guide to set things up manually:
🛠️ Quick Install
Install Package:
dotnet add package MudBlazor
Add to _Imports.razor
:
@using MudBlazor
Add to the MainLayout.razor
or App.razor
:
<MudThemeProvider/>
<MudPopoverProvider/>
<MudDialogProvider/>
<MudSnackbarProvider/>
Add to your HTML head
section:
<link href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap" rel="stylesheet" />
<link href="_content/MudBlazor/MudBlazor.min.css" rel="stylesheet" />
It's either index.html
or _Layout.cshtml
/_Host.cshtml
/App.razor
depending on whether you're running WebAssembly or Server.
Next, add to the default Blazor script at the end of the body
:
<script src="_content/MudBlazor/MudBlazor.min.js"></script>
Add to the relevant sections of Program.cs
:
using MudBlazor.Services;
builder.Services.AddMudServices();
🔗 Full Setup Guide
For more details, see the complete installation guide on our website.
💻 Example Usage
<MudText Typo="Typo.h6">
MudBlazor is @Text
</MudText>
<MudButton Variant="Variant.Filled"
Color="Color.Primary"
OnClick="ButtonOnClick">
@ButtonText
</MudButton>
@code {
string Text { get; set; } = "????";
string ButtonText { get; set; } = "Click Me";
int ClickCount { get; set; }
void ButtonOnClick()
{
ClickCount += 1;
Text = $"Awesome x {ClickCount}";
ButtonText = "Click Me Again";
}
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. 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. |
-
net8.0
- Microsoft.AspNetCore.Components (>= 8.0.12)
- Microsoft.AspNetCore.Components.Web (>= 8.0.12)
- Microsoft.Extensions.Localization (>= 8.0.12)
-
net9.0
- Microsoft.AspNetCore.Components (>= 9.0.1)
- Microsoft.AspNetCore.Components.Web (>= 9.0.1)
- Microsoft.Extensions.Localization (>= 9.0.1)
NuGet packages (226)
Showing the top 5 NuGet packages that depend on MudBlazor:
Package | Downloads |
---|---|
MudBlazor.ThemeManager
ThemeManager component for MudBlazor to design, test or do live changes to Mudblazor themes. |
|
FenixAlliance.ACL.Dependencies
Application Component for the Alliance Business Suite. |
|
CodeBeam.MudBlazor.Extensions
MudBlazor extension components from contributors. Includes 30+ components and utilities. |
|
MudBlazor.Markdown
Markdown component for MudBlazor (https://mudblazor.com/) |
|
Blauhaus.EVACS.Admin.Blazor
Package Description |
GitHub repositories (63)
Showing the top 20 popular GitHub repositories that depend on MudBlazor:
Repository | Stars |
---|---|
fullstackhero/dotnet-starter-kit
Production Grade Cloud-Ready .NET 9 Starter Kit (Web API + Blazor Client) with Multitenancy Support, and Clean/Modular Architecture that saves roughly 200+ Development Hours! All Batteries Included.
|
|
kurrent-io/KurrentDB
EventStoreDB, the event-native database. Designed for Event Sourcing, Event-Driven, and Microservices architectures
|
|
fullstackhero/blazor-starter-kit
Clean Architecture Template for Blazor WebAssembly Built with MudBlazor Components.
|
|
dotnet/samples
Sample code referenced by the .NET documentation
|
|
Nethereum/Nethereum
Ethereum .Net cross platform integration library
|
|
enkodellc/blazorboilerplate
Blazor Boilerplate / Starter Template with MudBlazor
|
|
asynkron/protoactor-dotnet
Proto Actor - Ultra fast distributed actors for Go, C# and Java/Kotlin
|
|
oleg-shilo/cs-script
C# scripting platform
|
|
Webreaper/Damselfly
Damselfly is a server-based Photograph Management app. The goal of Damselfly is to index an extremely large collection of images, and allow easy search and retrieval of those images, using metadata such as the IPTC keyword tags, as well as the folder and file names. Damselfly includes support for object/face detection.
|
|
ErsatzTV/ErsatzTV
Stream custom live channels using your own media
|
|
abpframework/abp-samples
Sample solutions built with the ABP Framework
|
|
DragoQCC/CrucibleC2
A C# Command & Control framework
|
|
neozhu/CleanArchitectureWithBlazorServer
This is a repository for creating a Blazor Server dashboard application following the principles of Clean Architecture
|
|
TheAxelander/OpenBudgeteer
OpenBudgeteer is a budgeting app based on the Bucket Budgeting Principle
|
|
Azure-Samples/azure-search-openai-demo-csharp
A sample app for the Retrieval-Augmented Generation pattern running in Azure, using Azure Cognitive Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences.
|
|
supabase-community/supabase-csharp
A C# Client library for Supabase
|
|
RatScanner/RatScanner
Rat Scanner a helpful tool for Escape from Tarkov.
|
|
petabridge/akkadotnet-code-samples
Akka.NET professional reference code samples
|
|
fullstackhero/blazor-wasm-boilerplate
Clean Architecture Boilerplate Template for .NET 6.0 Blazor WebAssembly built for FSH WebAPI with the goodness of MudBlazor Components.
|
|
CodeBeamOrg/CodeBeam.MudBlazor.Extensions
Useful third party extension components for MudBlazor, from the contributors.
|
Version | Downloads | Last updated |
---|---|---|
8.6.0 | 18,422 | 4/29/2025 |
8.5.1 | 151,476 | 3/31/2025 |
8.5.0 | 9,332 | 3/30/2025 |
8.3.0 | 211,637 | 2/23/2025 |
8.2.0 | 189,605 | 2/1/2025 |
8.0.0 | 116,674 | 1/18/2025 |
8.0.0-rc.2 | 5,818 | 1/9/2025 |
8.0.0-preview.7 | 4,790 | 12/26/2024 |
8.0.0-preview.6 | 2,387 | 12/17/2024 |
8.0.0-preview.5 | 8,338 | 11/22/2024 |
8.0.0-preview.4 | 10,838 | 10/30/2024 |
8.0.0-preview.3 | 685 | 10/28/2024 |
8.0.0-preview.2 | 760 | 10/22/2024 |
8.0.0-preview.1 | 2,279 | 10/13/2024 |
7.16.0 | 92,586 | 1/17/2025 |
7.15.0 | 675,333 | 10/29/2024 |
7.14.0 | 121,602 | 10/22/2024 |
7.13.0 | 112,999 | 10/17/2024 |
7.12.1 | 33,905 | 10/14/2024 |
7.12.0 | 8,464 | 10/14/2024 |
7.11.0 | 22,604 | 10/12/2024 |
7.10.0 | 14,757 | 10/11/2024 |
7.9.0 | 22,110 | 10/10/2024 |
7.8.0 | 367,704 | 9/6/2024 |
7.7.0 | 57,338 | 9/2/2024 |
7.6.0 | 282,901 | 8/6/2024 |
7.5.0 | 62,527 | 7/31/2024 |
7.4.0 | 68,941 | 7/23/2024 |
7.3.0 | 98,269 | 7/17/2024 |
7.2.0 | 26,346 | 7/15/2024 |
7.1.1 | 25,114 | 7/11/2024 |
7.1.0 | 11,730 | 7/10/2024 |
7.0.0 | 106,178 | 6/29/2024 |
7.0.0-rc.2 | 3,795 | 6/21/2024 |
7.0.0-rc.1 | 18,876 | 6/10/2024 |
7.0.0-preview.4 | 4,183 | 5/27/2024 |
7.0.0-preview.3 | 4,571 | 5/14/2024 |
7.0.0-preview.2 | 785 | 5/9/2024 |
7.0.0-preview.1 | 2,427 | 5/1/2024 |
6.21.0 | 317,992 | 7/6/2024 |
6.20.0 | 542,931 | 6/3/2024 |
6.19.1 | 973,974 | 3/22/2024 |
6.19.0 | 6,265 | 3/22/2024 |
6.18.0 | 49,688 | 3/20/2024 |
6.17.0 | 220,556 | 3/4/2024 |
6.16.0 | 201,334 | 2/19/2024 |
6.15.0 | 319,956 | 1/30/2024 |
6.14.0 | 115,180 | 1/22/2024 |
6.12.0 | 336,134 | 1/2/2024 |
6.11.2 | 212,359 | 12/18/2023 |
6.11.1 | 351,536 | 11/21/2023 |
6.11.0 | 501,149 | 10/8/2023 |
6.10.0 | 209,989 | 9/14/2023 |
6.9.0 | 227,061 | 8/18/2023 |
6.8.0 | 172,638 | 8/2/2023 |
6.7.0 | 251,432 | 7/10/2023 |
6.6.0 | 86,420 | 6/29/2023 |
6.5.0 | 55,066 | 6/24/2023 |
6.4.1 | 137,255 | 6/8/2023 |
6.4.0 | 8,775 | 6/7/2023 |
6.3.1 | 89,926 | 5/27/2023 |
6.3.0 | 58,098 | 5/24/2023 |
6.2.5 | 63,603 | 5/17/2023 |
6.2.3 | 141,875 | 5/3/2023 |
6.2.2 | 216,236 | 4/13/2023 |
6.2.1 | 48,153 | 4/12/2023 |
6.2.1-dev3 | 2,294 | 4/4/2023 |
6.2.1-dev2 | 1,787 | 3/30/2023 |
6.2.0 | 321,245 | 3/15/2023 |
6.1.10-dev1 | 3,854 | 3/2/2023 |
6.1.9 | 420,074 | 2/15/2023 |
6.1.8 | 192,063 | 1/27/2023 |
6.1.7 | 254,502 | 1/2/2023 |
6.1.6 | 78,624 | 12/18/2022 |
6.1.5 | 71,708 | 12/11/2022 |
6.1.4 | 74,297 | 12/5/2022 |
6.1.3-dev.1 | 2,560 | 11/22/2022 |
6.1.2 | 216,770 | 11/14/2022 |
6.1.0 | 70,527 | 11/13/2022 |
6.0.19-dev3 | 1,687 | 11/11/2022 |
6.0.19-dev1 | 2,515 | 11/10/2022 |
6.0.18 | 56,052 | 11/9/2022 |
6.0.17 | 208,639 | 10/10/2022 |
6.0.17-dev.1 | 4,027 | 9/22/2022 |
6.0.16 | 161,807 | 9/21/2022 |
6.0.15 | 271,585 | 8/31/2022 |
6.0.14 | 316,162 | 7/28/2022 |
6.0.13 | 104,209 | 7/26/2022 |
6.0.12 | 122,156 | 7/18/2022 |
6.0.11 | 259,264 | 7/1/2022 |
6.0.11-dev.4 | 7,498 | 5/30/2022 |
6.0.11-dev.3 | 1,339 | 5/24/2022 |
6.0.11-dev.2 | 530 | 5/21/2022 |
6.0.11-dev.1 | 843 | 5/20/2022 |
6.0.10 | 800,243 | 5/3/2022 |
6.0.10-dev.5 | 935 | 4/24/2022 |
6.0.10-dev.4 | 682 | 4/21/2022 |
6.0.10-dev.3 | 2,004 | 4/19/2022 |
6.0.10-dev.2 | 1,916 | 4/6/2022 |
6.0.10-dev.1 | 375 | 4/5/2022 |
6.0.9 | 240,959 | 3/29/2022 |
6.0.8 | 14,015 | 3/27/2022 |
6.0.7 | 267,953 | 2/25/2022 |
6.0.6 | 465,581 | 2/3/2022 |
6.0.5 | 84,354 | 1/17/2022 |
6.0.4 | 35,005 | 1/3/2022 |
6.0.3 | 3,929 | 12/31/2021 |
6.0.2 | 245,255 | 11/9/2021 |
5.2.5 | 26,672 | 9/29/2022 |
5.2.4 | 60,883 | 1/7/2022 |
5.2.0 | 89,073 | 10/31/2021 |
5.1.5 | 82,599 | 9/27/2021 |
5.1.4 | 58,845 | 9/13/2021 |
5.1.3 | 27,441 | 9/6/2021 |
5.1.2 | 21,583 | 8/24/2021 |
5.1.1 | 11,294 | 8/20/2021 |
5.1.0 | 74,125 | 7/27/2021 |
5.0.15 | 53,509 | 6/28/2021 |
5.0.14 | 42,726 | 6/21/2021 |
5.0.13 | 14,333 | 6/15/2021 |
5.0.11 | 15,864 | 6/7/2021 |
5.0.10 | 20,705 | 5/24/2021 |
5.0.9 | 20,602 | 5/17/2021 |
5.0.8 | 20,610 | 4/25/2021 |
5.0.7 | 30,344 | 3/29/2021 |
5.0.6 | 13,532 | 3/16/2021 |
5.0.5 | 14,152 | 3/8/2021 |
5.0.3 | 10,787 | 3/1/2021 |
5.0.2 | 6,994 | 2/21/2021 |
5.0.1 | 10,294 | 2/10/2021 |
5.0.0 | 7,915 | 2/6/2021 |
2.0.7 | 50,542 | 3/29/2021 |
2.0.6 | 4,085 | 3/16/2021 |
2.0.5 | 2,738 | 3/8/2021 |
2.0.4 | 2,165 | 3/8/2021 |
2.0.3 | 2,171 | 3/1/2021 |
2.0.2 | 2,328 | 2/21/2021 |
2.0.0 | 7,681 | 2/5/2021 |
1.2.4 | 14,072 | 12/30/2020 |
1.2.1 | 4,022 | 12/17/2020 |
1.2.0 | 3,215 | 12/7/2020 |
1.1.5 | 4,283 | 11/29/2020 |
1.1.4 | 2,553 | 11/23/2020 |
1.1.3 | 9,271 | 11/16/2020 |
1.1.2 | 2,116 | 11/11/2020 |
1.1.1 | 2,181 | 11/5/2020 |
1.1.0 | 2,003 | 11/2/2020 |
1.0.9 | 2,156 | 10/26/2020 |
1.0.8 | 2,009 | 10/23/2020 |
1.0.7 | 1,903 | 10/18/2020 |
1.0.6 | 1,875 | 10/11/2020 |
1.0.5 | 1,977 | 10/8/2020 |
1.0.4 | 1,941 | 10/2/2020 |
1.0.3 | 2,068 | 9/20/2020 |
1.0.2 | 2,027 | 9/20/2020 |
1.0.1 | 1,935 | 9/11/2020 |
1.0.0 | 13,735 | 9/11/2020 |