# Set up your machine to use the latest FluentUI-Blazor package

These instructions will get you set up with the latest build of **FluentUI-Blazor**.

Each time a commit is pushed to `dev`, the **Core** package is published on a special NuGet repository.
Install the latest [Visual Studio 2022 Preview version](https://visualstudio.microsoft.com/vs/preview/)
or [Visual Studio 2026 Insider edition](https://visualstudio.microsoft.com/insiders/) for the tooling.

**This package is a preliminary version and are not intended for production use.
It is intended to be used to test the latest feature and bug fix.**

If you just want the last final release of **FluentUI-Blazor**, the packages are on [NuGet.org](https://www.nuget.org/packages/Microsoft.FluentUI.AspNetCore.Components).

## Add necessary NuGet feed

The latest builds are pushed to a special feed, which you need to add:
```sh
dotnet nuget add source --name dotnet9 https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json
```

As usual this will add the feed to any existing NuGet.config in the directory or above,
or else in the global NuGet.config. See [configuring NuGet behavior](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior) to read more about that.

Alternatively, if you are using Visual Studio, you can [Install and manage packages in Visual Studio](https://learn.microsoft.com/nuget/consume-packages/install-use-packages-visual-studio#package-sources)
and add the feed `https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json` there.

Example `nuget.config` file (adapt to your environment):
```json
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
    <add key="preview" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json" />
  </packageSources>

  <packageSourceMapping>
    <packageSource key="nuget.org">
      <package pattern="*" />
      <package pattern="Microsoft.FluentUI.AspNetCore.Components.Emoji" />
      <package pattern="Microsoft.FluentUI.AspNetCore.Components.Icons" />
    </packageSource>

    <packageSource key="preview">
      <package pattern="Microsoft.FluentUI.AspNetCore.Components" />
    </packageSource>
  </packageSourceMapping>
</configuration>
```

## Restore error

If you get the error **NU3018** `The author primary signature's signing certificate is not trusted by the trust provider`
or **NU3027** `The signature should be timestamped to enable long-term signature validity after the certificate has expired`,
you can work around it by adding the following to your project file:

```xml
<PropertyGroup>
  <NoWarn>NU3018;NU3027</NoWarn>
</PropertyGroup>
```

## NuGet’s Central Package Management (CPM)

If you are using the NuGet’s Central Package Management (CPM) feature, you probably need to set `ManagePackageVersionsCentrally=false`

Example (update the version number with the lastest values):

```xml
<PropertyGroup>
  <ManagePackageVersionsCentrally>false</ManagePackageVersionsCentrally>
</PropertyGroup>

 <ItemGroup>
  <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components" Version="5.0.0-preview.25286.1" />
  <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components.Icons" Version="4.13.0" />
</ItemGroup>
```

## Documentation

The documentation for this preliminary version is available at [https://fluentui-blazor-v5.azurewebsites.net/](https://fluentui-blazor-v5.azurewebsites.net/).

## Contributing

If you would like to contribute to this project, please read the document [contributing.md](contributing.md)