Themeship vs the default MudBlazor theme
MudBlazor's default theme is a solid place to start. Themeship is for when you want your brand in the product without hand-writing every MudTheme token.
Who should pick which
Stick with the default MudBlazor theme if you're building an internal tool, a quick prototype, or you don't have brand colors yet. It looks clean and works out of the box.
Pick Themeship when your app needs to look like your product in light and dark, and you'd rather not hand-write a MudTheme and check contrast yourself.
Either way, you're still on MudBlazor. Themeship just handles the theme step.
The default theme is a good start
MudBlazor is a great component library. You can add MudThemeProvider with no theme set, and you get the default look, including a dark palette. A lot of apps should start there.
The extra work starts when you want the UI to look like your product, not like the default palette. Then you're writing a MudTheme by hand: PaletteLight, PaletteDark, contrast text, typography, layout. It's easy to miss a token, and it's easy to skip the contrast check.
What Themeship does differently
Themeship is a free MudBlazor theme generator from El Rey Studios. You put in 1 to 3 brand colors. It builds the light and dark palettes, shows them on a real MudBlazor dashboard, checks 88 WCAG AA contrast pairs, and exports paste-ready C# for MudBlazor 8.x and 9.x.
It isn't a replacement for MudBlazor, and it isn't affiliated with the MudBlazor team. It's a generator for the theme step.
Side by side
| Default MudTheme | Themeship | |
|---|---|---|
| Starting point | MudBlazor's default light and dark palettes, ready to use with no theme written | You enter 1 to 3 brand colors |
| Light and dark | Included in the default theme | Generated from your colors |
| Typography and layout | Default values, or you set them by hand | Included in the generated MudTheme |
| Contrast | You check it yourself | Checks 88 WCAG AA pairs in light and dark. A fresh theme starts at 88/88 |
| Preview | In your own app, once you wire the theme up | Live preview on a real MudBlazor dashboard, plus a forms preview |
| Output | You write the C# | Copy C# or export a .cs file, written for MudBlazor 8.x and 9.x |
| Cost | Free, as part of MudBlazor | Free generator, runs in your browser on .NET 10 LTS |
The C#, side by side
A hand-written MudTheme and a Themeship export are the same kind of object. The difference is how much of it you have to type, and whether contrast was checked before you pasted it in.
MudThemeusing MudBlazor;
namespace MyApp;
public static class AppTheme
{
public static readonly MudTheme Theme = new()
{
PaletteLight = new PaletteLight
{
Primary = "#6D28D9",
Secondary = "#116CDE",
AppbarBackground = "#6D28D9",
// Still to write: Darken, Lighten and ContrastText for each color,
// Info, Success, Warning, Error, text, lines, table and background colors.
},
PaletteDark = new PaletteDark
{
Primary = "#A387FD",
// Still to write: the rest of the dark palette.
// Still to check: does each text color pass 4.5:1 on its background?
},
Typography = new Typography
{
Default = new DefaultTypography { FontFamily = new[] { "Inter", "Helvetica", "Arial", "sans-serif" } },
},
LayoutProperties = new LayoutProperties { DefaultBorderRadius = "8px" },
};
}
#6D28D9 (Static class, Set values)// Generated by Themeship (https://themeship.elreystudios.dev) for MudBlazor 8.x / 9.x (C# 12, net8.0+).
// Themeship is an independent tool for MudBlazor. Not affiliated with or endorsed by the MudBlazor team.
//
// Usage: add this file to your project, then in the component that holds your <MudThemeProvider>
// (usually Layout/MainLayout.razor) set the theme field in one line:
// private MudTheme _theme = BrandThemeTheming.BrandTheme.Theme;
// and make sure the provider uses it:
// <MudThemeProvider Theme="_theme" @bind-IsDarkMode="_isDarkMode" />
//
// Font: this theme uses Inter. Add it to wwwroot/index.html (or App.razor) <head>,
// or self-host it; otherwise the browser falls back to Helvetica/Arial:
// <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
using MudBlazor;
namespace BrandThemeTheming;
public static class BrandTheme
{
public static readonly MudTheme Theme = new()
{
PaletteLight = new PaletteLight
{
Primary = "#6D28D9",
PrimaryDarken = "#611DC5",
PrimaryLighten = "#8F5FFF",
Secondary = "#116CDE",
SecondaryDarken = "#0050AE",
SecondaryLighten = "#2681FC",
Tertiary = "#AF43AF",
TertiaryDarken = "#861E87",
TertiaryLighten = "#C24FC2",
Info = "#026FD7",
InfoDarken = "#0053A5",
InfoLighten = "#1E84F4",
Success = "#14823E",
SuccessDarken = "#00672D",
SuccessLighten = "#329E54",
Warning = "#A36100",
WarningDarken = "#A46100",
WarningLighten = "#BA731A",
Error = "#D42325",
ErrorDarken = "#A3000E",
ErrorLighten = "#EE3533",
Dark = "#42414A",
DarkDarken = "#302F35",
DarkLighten = "#55545D",
Background = "#FAFAFD",
AppbarBackground = "#6D28D9",
DrawerText = "#191527",
DrawerIcon = "#585568",
TextPrimary = "#191527",
TextSecondary = "#585568",
TextDisabled = "#A5A3AD",
ActionDefault = "#585568",
ActionDisabled = "#AEADB4",
ActionDisabledBackground = "#E4E4EA",
Divider = "#E1E0E7",
DividerLight = "#EEEEF2",
LinesDefault = "#E1E0E7",
LinesInputs = "#93929C",
TableLines = "#E8E7ED",
TableStriped = "#F8F8FC",
TableHover = "#F2F0F9",
BackgroundGray = "#F2F1F6",
},
PaletteDark = new PaletteDark
{
Primary = "#A387FD",
PrimaryContrastText = "#0E0D13",
PrimaryDarken = "#9374EF",
PrimaryLighten = "#BFB1FF",
Secondary = "#5B9EFF",
SecondaryContrastText = "#0E0D13",
SecondaryDarken = "#4187EB",
SecondaryLighten = "#95C0FF",
Tertiary = "#D574D4",
TertiaryContrastText = "#0E0D13",
TertiaryDarken = "#C661C6",
TertiaryLighten = "#EF9BED",
Info = "#65A7FA",
InfoContrastText = "#0E0D13",
InfoDarken = "#458ADF",
InfoLighten = "#91C1FF",
Success = "#61CB7C",
SuccessContrastText = "#0E0D13",
SuccessDarken = "#4CBC6B",
SuccessLighten = "#A6EBB3",
Warning = "#FCB442",
WarningContrastText = "#0E0D13",
WarningDarken = "#D79100",
WarningLighten = "#FFCE8B",
Error = "#F66D67",
ErrorContrastText = "#0E0D13",
ErrorDarken = "#E65753",
ErrorLighten = "#FFA098",
Dark = "#BEBCC8",
DarkContrastText = "#0E0D13",
DarkDarken = "#A2A0AC",
DarkLighten = "#D7D6DF",
Background = "#0E0D13",
Surface = "#1A1820",
AppbarBackground = "#211F27",
AppbarText = "#EEEEF3",
DrawerBackground = "#14131A",
DrawerText = "#EEEEF3",
DrawerIcon = "#B1AFBD",
TextPrimary = "#EEEEF3",
TextSecondary = "#B1AFBD",
TextDisabled = "#63626A",
ActionDefault = "#B1AFBD",
ActionDisabled = "#55545A",
ActionDisabledBackground = "#29282E",
Divider = "#2E2D34",
DividerLight = "#242329",
LinesDefault = "#2E2D34",
LinesInputs = "#66656E",
TableLines = "#29282F",
TableStriped = "#1E1D24",
TableHover = "#23212B",
BackgroundGray = "#16151B",
GrayDarker = "#D7D6E0",
},
Typography = new Typography
{
Default = new DefaultTypography
{
FontFamily = ["Inter", "Helvetica", "Arial", "sans-serif"],
FontSize = ".875rem",
LineHeight = "1.5",
},
H4 = new H4Typography { FontWeight = "650", LetterSpacing = "-.015em" },
H5 = new H5Typography { FontWeight = "650", LetterSpacing = "-.015em" },
H6 = new H6Typography { FontWeight = "600" },
Button = new ButtonTypography { FontWeight = "600", TextTransform = "none" },
},
LayoutProperties = new LayoutProperties
{
DefaultBorderRadius = "10px",
AppbarHeight = "56px",
},
};
}
FAQ
Should I replace the default MudTheme?
Only if you want your brand in the UI. The default theme is a solid starting point. Themeship is there for the step after that.
Will the export work in an app that already uses the default theme?
Yes. You still use MudThemeProvider. You pass it the generated MudTheme instead of relying on the default. The export is written for MudBlazor 8.x and 9.x, and it targets C# 12 and net8.0 or later.
Does every color I pick pass all 88 checks?
No. A fresh theme starts at 88/88. If you edit a color and a pair fails, the contrast panel shows what failed. It can fix pairs that use generated colors, one at a time or all at once. A color you set yourself stays as you set it, so edit it again or unlock it. Fix all does not always bring every pair back to a pass, so check the badge before you export.
Is Themeship part of MudBlazor?
No. Themeship is an independent tool for MudBlazor. Not affiliated with or endorsed by the MudBlazor team.
Is it free?
Yes. The generator is free to use in your browser. First visit downloads the .NET runtime once (about 3.5 MB). After that it opens from cache.
Open the generator and try your brand colors against the default look.
Want the shorter walkthrough first? See the MudBlazor theme generator page.