https://github.com/mudblazor/mudblazor
Blazor Component Library based on Material Design principles with an emphasis on ease of use and extensibility
https://github.com/mudblazor/mudblazor
blazor blazor-client blazor-components blazor-server blazor-webassembly component component-library components csharp hacktoberfest material netcore wasm
Last synced: 18 days ago
JSON representation
Blazor Component Library based on Material Design principles with an emphasis on ease of use and extensibility
- Host: GitHub
- URL: https://github.com/mudblazor/mudblazor
- Owner: MudBlazor
- License: mit
- Created: 2020-08-18T10:47:27.000Z (over 5 years ago)
- Default Branch: dev
- Last Pushed: 2025-05-07T17:43:22.000Z (10 months ago)
- Last Synced: 2025-05-07T23:38:28.616Z (10 months ago)
- Topics: blazor, blazor-client, blazor-components, blazor-server, blazor-webassembly, component, component-library, components, csharp, hacktoberfest, material, netcore, wasm
- Language: C#
- Homepage: http://mudblazor.com
- Size: 36.5 MB
- Stars: 9,005
- Watchers: 107
- Forks: 1,416
- Open Issues: 1,463
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# 
# Material Design components for Blazor
[](https://sonarcloud.io/summary/overall?id=MudBlazor_MudBlazor)
[](https://app.codecov.io/github/MudBlazor/MudBlazor)
[](https://github.com/mudblazor/MudBlazor/blob/master/LICENSE)
[](https://github.com/mudblazor/MudBlazor/stargazers)
[](https://github.com/mudblazor/mudblazor/graphs/contributors)
[](https://github.com/mudblazor/mudblazor/discussions)
[](https://discord.gg/mudblazor)
[](https://twitter.com/MudBlazor)
[](https://www.nuget.org/packages/MudBlazor/)
[](https://www.nuget.org/packages/MudBlazor/)
Build stunning, interactive web applications with MudBlazor — the open-source Material Design library for Blazor.
**🌐 [Documentation](https://mudblazor.com/docs/overview) ⚡ [Interactive Playground](https://try.mudblazor.com)**
## 💎 Why Choose MudBlazor?
📖 Comprehensive documentation and examples
🎨 Beautiful Material Design components
💻 Write in C# with minimal JavaScript
✅ Extensive test coverage
## 📊 Repo Stats
## 🚀 Getting Started
Use one of our [templates](https://github.com/MudBlazor/Templates), or follow the quick install guide below:
### Installation
Install Package:
```bash
dotnet add package MudBlazor
```
Add to `_Imports.razor`:
```razor
@using MudBlazor
```
Add to `MainLayout.razor` or `App.razor`:
```razor
```
Add to HTML `head` section (`index.html`/`_Layout.cshtml`/`_Host.cshtml`/`App.razor`):
```razor
```
Add to the default Blazor script at the end of the HTML `body` section:
```razor
```
Add to `Program.cs`:
```c#
using MudBlazor.Services;
```
```c#
builder.Services.AddMudServices();
```
### Example Usage
```razor
MudBlazor is @Text
@ButtonText
@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";
}
}
```
For more details, see the [full installation guide](https://mudblazor.com/getting-started/installation).
## 🤝 Contributing
Contributions from the community are what make MudBlazor successful.
💬 Feel free to chat with us [on Discord](https://discord.gg/mudblazor) to get feedback before diving in.
📚 Check out our [contribution guidelines](/CONTRIBUTING.md) to get started and learn more about how the project works.
🧪 If a PR fixes something you reported, [locally test it](https://github.com/MudBlazor/MudBlazor/discussions/12085) to ensure your app works as expected.
## ⚙️ Version Support
| MudBlazor | .NET | Support |
| :--- | :---: | :---: |
| 5.x.x | .NET 5 | Ended Jan 2022 |
| 6.x.x | [.NET 6](https://dotnet.microsoft.com/download/dotnet/6.0), [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | Ended Jan 2025 |
| 7.x.x | [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | Ended Jan 2026 |
| 8.x.x | [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0), [.NET 9](https://dotnet.microsoft.com/download/dotnet/9.0) | Limited Support |
| 9.x.x | [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0), [.NET 9](https://dotnet.microsoft.com/download/dotnet/9.0), [.NET 10](https://dotnet.microsoft.com/download/dotnet/10.0) | ✅ Full Support |
> [!NOTE]
> 1. Upgrading? Check our [Migration Guide](https://github.com/MudBlazor/MudBlazor/discussions/12086) for help with breaking changes.
> 2. Static rendering is not supported. [Learn more](https://learn.microsoft.com/aspnet/core/blazor/components/render-modes)
> 3. Use an up-to-date browser. [Blazor supported platforms](https://learn.microsoft.com/aspnet/core/blazor/supported-platforms)
> 4. Want to test the latest features? Learn about our [nightly builds](https://github.com/MudBlazor/MudBlazor/discussions/12621)!