Using the DSP Tooling in Uno.Material


Is it possible to automate the creation of the Material Design color palette? Yes, it is. Uno.Material provides a tooling to generate the color palette from the official Material Design color palette. This tooling is available in the Uno.Dsp.Cli and Uno.Dsp.Tasks NuGet packages. The following instructions will cover the Uno.Dsp.Tasks version, which is more automatic.


Make sure you are referencing the generated XAML file in your application's App.xaml file, as shown in the following example:

 <MaterialTheme xmlns="using:Uno.Material"
                ColorOverrideSource="ms-appx:///PROJECT_NAME/Styles/Application/MaterialColorsOverride.xaml" />

More details In the Manual Color Overrides section of the Getting Started page

The Uno.Dsp.Tasks NuGet package

This package will be automatically present in the project after creating a new Uno Platform project specifying the Material theme. It is also possible to add it manually to an existing Uno Platform project by adding the following line to the PackageReference section of the csproj file:

  • Add a nuget package reference:

    <PackageReference Include="Uno.Dsp.Tasks" Version="[latest version]" />
  • The package is already present when you select Material theme during project creation:

Generating a custom color palette and export as DSP file

  1. Navigate to the Material Theme Builder and select the colors you want to use for your application.

  2. Locate the Export button and pick the material Tokens (DSP) format.

    Export Button DSP Selection

  3. Save the zip file to your computer.

  4. Replace the file in the Styles folder of your application project with the one you just downloaded.

  5. Build your application. The ColorPaletterOverride.xaml file will be automatically updated with the colors present in the DSP zip file.

More flexibility

This will generate the file at each build, potentially overriding any changes you made to the file. If you want to keep it that way, you can simply remove the file from the Styles folder, the file won't get overwritten anymore.

Alternatively, you can also use the Uno.Dsp.Cli package to generate the file from the command line. This will allow you to generate the file only when you want to, and not at each build.