Skip to content

Community-Toolkit-for-Fluent-UI-Blazor/fluentui-blazor-community-extensions

Repository files navigation

FluentUI Blazor Community Extensions

This package is for use in .NET 9 Blazor projects.

Introduction

The FluentUI.Blazor.Community.Components package provides a collection of open-source Razor components that extend the official Microsoft FluentUI Blazor Library.

Documentation on the components is available at the demo site.

Component Overview

The components are organized into two main categories:

1. Custom Components

These components are specifically designed to seamlessly follow the FluentUI design principles, offering additional functionality and consistent styling beyond what the official library provides.

2. Composite Components

These components are created by combining multiple official FluentUI components. They deliver higher-level building blocks that represent common UI patterns out of the box.

Getting Started

To using this library, you first need to install the package via NuGet. You can use the NuGet package manager in your IDE or use the following command when using a CLI:

dotnet add package FluentUI.Blazor.Community.Components

Add Imports

After the package is added, you need to add the following in your _Imports.razor

@using FluentUI.Blazor.Community.Components

Development

Building and Testing

To build the project locally:

dotnet restore
dotnet build --configuration Release
dotnet test

NuGet Package Deployment

This repository includes automated GitHub Actions workflows for deploying packages to NuGet.org:

  • Automatic Deployment: Push a version tag (e.g., v1.0.1) to trigger deployment
  • Manual Deployment: Use the "Deploy to NuGet" workflow in GitHub Actions

For detailed instructions, see .github/workflows/README-deploy-nuget.md.

Support

The FluentUI Blazor Community Extensions is an open source project. It is built and maintained by community members and offers support, like most other open source projects, on a best effort base through the GitHub repository only.