fluentui-blazor

# Microsoft Fluent UI Blazor components

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![NuGet component library](https://img.shields.io/nuget/vpre/Microsoft.FluentUI.AspNetCore.Components?label=NuGet%20Component%20Library)](https://www.nuget.org/packages/Microsoft.FluentUI.AspNetCore.Components)
[![NuGet templates](https://img.shields.io/nuget/vpre/Microsoft.FluentUI.AspNetCore.Templates?label=NuGet%20Templates)](https://www.nuget.org/packages/Microsoft.FluentUI.AspNetCore.Templates)
[![Validate Security](https://github.com/microsoft/fluentui-blazor/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/microsoft/fluentui-blazor/actions/workflows/codeql-analysis.yml)

:star:  We appreciate your star, it helps!

**Fluent UI Blazor** is a component library for building Blazor applications with Microsoft's Fluent design language. It includes components based on the official Fluent UI Web Components as well as Blazor-specific components and services.

> [!IMPORTANT]
> This branch contains Fluent UI Blazor v5. See the [v5 documentation and demos](https://www.fluentui-blazor.net) and the [v4 to v5 migration guide](https://www.fluentui-blazor.net/MigrationV5).

If you'd like to view the code for version 4, navigate to the [archive-v4](https://github.com/microsoft/fluentui-blazor/tree/archive-v4) branch.

> ✅ UPDATE 2026-09-17:
> Active v5 development has moved from the old `dev-v5` branch to
> the `dev` branch. If your local repository previously used `dev-v5` branch,
> run the following commands from its folder to switch to and track
> the new active development branch:
>

> ```shell
> git fetch origin --prune
> git switch --track -c dev origin/dev
> git pull --ff-only origin dev
> ```

## Introduction

The `Microsoft.FluentUI.AspNetCore.Components` package provides a set of [Blazor](https://blazor.net) components
which are used to build applications that have a [Fluent design](https://developer.microsoft.com/en-us/fluentui#/)
(i.e. have the look and feel of modern Microsoft applications).

Some of the components in the library are wrappers around Microsoft's official **Fluent UI Web Components**.
Others are components that leverage the Fluent Design System or make it easier to work with Fluent UI.
To get up and running with the library, see the **Getting Started** section below.

The source for the library is hosted in the [fluentui-blazor](https://github.com/microsoft/fluentui-blazor) repository
at GitHub. Documentation on the components is available at the [demo site](https://www.fluentui-blazor.net).

## Upgrading from an earlier version

If you are upgrading from an earlier version of the library, please see the [what's new](https://www.fluentui-blazor.net/whatsnew) for information on (breaking) changes.

## Create a project from a template

The template package provides ready-to-run Fluent UI versions of the standard Blazor templates:

- Fluent Blazor Web App
- Fluent B