Skip to content

Repository files navigation

MudBlazor Icons: Material Icons & Material Symbols for Blazor

License Discord Twitter

Every Google Material icon, ready for MudBlazor. Two official NuGet packages cover the complete Material Icons and Material Symbols collections, over 22,000 icons in total, each one a strongly typed C# constant.

<MudIcon Icon="@MudBlazor.FontIcons.MaterialSymbols.Outlined.Rocket" />

Why these packs?

  • Every icon, every style. Thousands of icons MudBlazor's built-in set doesn't include, plus the entire Material Symbols collection.
  • IntelliSense, not magic strings. Your editor autocompletes icon names, and typos become build errors.
  • Self-hosted fonts. No Google CDN, no third-party requests. Works offline and in air-gapped environments.
  • Trimming and AOT compatible. Safe for Blazor WebAssembly trimming and Native AOT.
  • Runs everywhere Blazor does. Server, WebAssembly, and Hybrid (.NET MAUI).

Quick start

  1. Install a package:
dotnet add package MudBlazor.FontIcons.MaterialSymbols
  1. Add the stylesheet next to your MudBlazor stylesheet (in App.razor, index.html, or your host page):
<link href="_content/MudBlazor.FontIcons.MaterialSymbols/css/font.min.css" rel="stylesheet" />
  1. Use any icon, anywhere MudBlazor accepts one:
<MudIcon Icon="@MudBlazor.FontIcons.MaterialSymbols.Outlined.Database" />
<MudIconButton Icon="@MudBlazor.FontIcons.MaterialSymbols.Rounded.Settings" />

That's it. The usage guides cover aliases, font preloading, CDN options, and troubleshooting.

Choosing a pack

MudBlazor.FontIcons.MaterialSymbols MudBlazor.FontIcons.MaterialIcons
Icon set Material Symbols, Google's current set, still growing Material Icons, the classic set, stable but frozen
Styles Outlined, Rounded, Sharp Filled, Outlined, Rounded, Sharp, Two-Tone
Icons per style 3,800+ 2,100+
NuGet NuGet version NuGet downloads NuGet version NuGet downloads
Guide Material Symbols guide Material Icons guide

Undecided? Pick Material Symbols. It's the set Google still adds to. Choose Material Icons if you want the Filled or Two-Tone styles, or install both; they coexist happily.

Both packages require MudBlazor 7.0.0+ and .NET 8, 9, or 10.

FAQ

How is this different from MudBlazor's built-in icons?

The built-in Icons.Material classes cover a curated subset of Material Icons as SVGs. These packs deliver the complete collections as icon fonts, including Material Symbols, which MudBlazor core doesn't ship at all. Mix them freely in the same app.

Do I need an internet connection or Google's CDN?

No. The fonts live in the NuGet package and are served by your own app. A Google Fonts CDN option exists if you prefer it; see the usage guides.

Where do I browse the icons?

Google Fonts. Find rocket_launch there, use Outlined.RocketLaunch here.

How do the packs stay current?

A generator in this repository rebuilds the icon classes and fonts from Google's official metadata, and updates ship to NuGet.

Contributing and support

License

MIT. The Material Icons and Material Symbols fonts are created by Google under the Apache License 2.0.

About

Official Material Icons and Material Symbols packs for MudBlazor. Over 22,000 Google icons as strongly typed C# constants for Blazor, with self-hosted fonts and IntelliSense.

Topics

Resources

Code of conduct

Contributing

Stars

31 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages