<!-- omit in toc -->

Material Design In XAML Toolkit

[][discord-server-url]

Comprehensive and easy to use Material Design theme and control library for the Windows desktop (WPF).

• Material Design styles for all major WPF Framework controls
• Additional controls to support the theme, including Multi Action Button, Cards, Dialogs, Clock
• Easy configuration of palette (at design and runtime), according to Google's guidelines
• Full Material Design Icons icon pack
• Easy transition effects
• Compatible with Dragablz, MahApps
• Demo applications included in the source project

See screenshots

<details> <summary>Table of contents</summary>

• Getting started
• Building the source
• Screenshots
• More examples
• FAQ
• Contributing
• Mentions
• Backers
• Sponsors

</details>

---

Getting started

[!NOTE] See the full starting guide for more in-depth information.

This quick guide assumes you have already created a WPF project and are using Microsoft Visual Studio 2022.

• Install the toolkit through the visual NuGet package manager in Visual Studio or use the following command:

Install-Package MaterialDesignThemes

• Alter your App.xaml

<Application 
  x:Class="Example.App"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:materialDesign="http://materialdesigninxaml.net/winfx/xaml/themes"
  StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <materialDesign:BundledTheme BaseTheme="Light" PrimaryColor="DeepPurple" SecondaryColor="Lime" />

                <ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesign2.Defaults.xaml" /> 
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

• If you want to target Material Design 3, alter the ResourceDictionary line in the snippet above to use MaterialDesign3.Defaults.xaml.

• Alter your MainWindow.xaml

<Window [...]
  Style="{StaticResource MaterialDesignWindow}"
  [...] >

Building the source

To build the project, following is required:

• Microsoft Visual Studio 2022
• .NET desktop development workload

This repository also contains 3 different demo applications:

• MaterialDesignDemo - Reference WPF app with Material Design 2 styling, this contains all controls and is a recommended tool when developing apps with this library
• MaterialDesign3Demo - Reference WPF app with Material Design 3 styling, under development
• MahAppsDragablzDemo - Demo app for combining with Dragablz and MahApps

Screenshots

<details> <summary>Material Design 3 demo app screenshots</summary>

</details> <details> <summary>Material Design 2 demo app screenshots</summary>

[!WARNING] The screenshots below are taken from the Material Design 2 demo app. Material Design 3 is the latest version, so the UI shown here may differ from the latest design.

</details>

More examples

• Keboo/MaterialDesign.Examples
• Motion List

FAQ

• How to increase rendering performance?

Contributing

Before contributing code read the Contribution Guidelines

• GitHub issues are for bugs and feature requests.
• For questions, help and chat in general, please use the GitHub discussion tab or the [Discord server][discord-server-url].
• Stack Overflow tag: material-design-in-xaml

Want to say thanks? 🙏🏻

• Hit the :star: star :star: button
• If you'd like to make a very much appreciated financial donation please visit <a href='https://opencollective.com/materialdesigninxaml'>open collective</a>

This project exists thanks to all the people who contribute.

<a href="https://github.com/MaterialDesignInXAML/MaterialDesignInXamlToolkit/graphs/contributors"> <img src="https://contrib.rocks/image?repo=MaterialDesignInXAML/MaterialDesignInXamlToolkit" /> </a>

Mentions

• James Willock - Founder of the project
• Kevin Bost - Maintainer of the repository
• Snalty [![Twitter](https://img.shields.io/badge/twitter-%40sn