Migrating from MudBlazor

The approach

The enums, icon constants, dialog service and snackbar service keep the same shapes you already use, so most markup and code-behind compiles after a rename with minimal edits.

The shared enums

These live in the DaisyBlazor namespace with the same names and members MudBlazor uses, mapped onto daisyUI tokens:

Other familiar enums are present too: Justify, AlignItems, MaxWidth, Adornment, Origin, Anchor, Breakpoint, DrawerVariant, ButtonType, SortDirection, InputType, Margin, Underline, Wrap, and more, so Color.Primary, Variant.Outlined, Size.Small, Typo.h6 and Severity.Success all keep working after the tag rename.

Icons

Icons.Material.Filled.* and Icons.Material.Outlined.* constants exist just like in MudBlazor:

<Button StartIcon="@Icons.Material.Filled.Check">OK</Button>
<Icon Name="@Icons.Material.Filled.Delete" />

The values are Material Symbols ligatures (e.g. Icons.Material.Filled.Check == "check"), rendered by the Icon component via the Material Symbols webfont, so make sure that font is loaded in your host page (see CSS preset). The constant set covers the commonly used icons; because the values are just ligature strings, you can also pass any Material Symbols name directly (<Icon Name="rocket_launch" />).

Dialogs

Inject IDialogService exactly as before. It's registered by AddDaisyBlazor(), and a single <DialogProvider /> mounted in your layout renders the dialogs.

@inject IDialogService DialogService

@code {
    private async Task Open()
    {
        DialogParameters parameters = new() { { "Message", "Are you sure?" } };
        IDialogReference dialog = await DialogService.ShowAsync<MyDialog>("Confirm", parameters);
    }

    private async Task Confirm()
    {
        bool? ok = await DialogService.ShowMessageBoxAsync(
            "Delete item", "This cannot be undone.", yesText: "Delete", cancelText: "Cancel");
    }
}

deleteTry ShowMessageBoxAsync

Compatible types: IDialogService, DialogParameters (dictionary and collection-initializer syntax) and DialogParameters<T> (the { x => x.Prop, value } selector syntax), DialogOptions, DialogResult, IDialogReference. The built-in confirm dialog is MessageBoxDialog, surfaced through ShowMessageBoxAsync(...) (returns true = yes, false = no, null = canceled/dismissed).

Dialogs open as true modals (showModal(): focus moves in, the page behind is inert, focus returns to the opener on close) and are labelled by their title. Escape cancels unless DialogOptions.CloseOnEscapeKey = false; DialogOptions.AlertDialog forces role="alertdialog" (the default for MessageBoxDialog and ConfirmDialog). Localise the close button with <DialogProvider CloseLabel="Fermer" />.

Snackbar

Inject ISnackbar and call Add with a Severity, just like MudBlazor. It's registered by AddDaisyBlazor(); mount one <SnackbarProvider /> in your layout.

@inject ISnackbar Snackbar

@code {
    private void Notify() => Snackbar.Add("Saved!", Severity.Success);
}

checkTry Snackbar.Add

ISnackbar exposes Add(message, severity, configure), Remove, Clear, the Shown list and an OnChange event. Toasts are announced once through a single live region (assertive for errors and warnings, polite otherwise), pause their auto-hide while hovered or focused, and the close button label is localisable via <SnackbarProvider CloseLabel="Fermer" />.

Setup deltas

Component name map

Drop the Mud prefix. A representative mapping, each linking to its component page:

Beyond MudBlazor

DaisyBlazor also adds daisyUI-native components with no MudBlazor equivalent: Hero, Stats/Stat, Steps/Step, Timeline, ChatBubble, Countdown, Diff, Kbd, Mask, Swap, Dock, Indicator, Status, Carousel, and the Mockup* family. See the component reference for the full list.

Migration recipe

1. Replace AddMudServices() with AddDaisyBlazor() and add the Tailwind/daisyUI build (or scaffold a fresh app with dotnet new daisyblazor and copy your pages in).
2. Swap @using MudBlazor for @using DaisyBlazor (+ @using DaisyBlazor.Theming).
3. Replace the Mud providers with ThemeProvider / DialogProvider / SnackbarProvider.
4. Rename MudX tags to X page by page; the enums, Icons.*, IDialogService and ISnackbar keep working. Fix the occasional parameter that differs, and re-check styling against your daisyUI theme.