README

Material Design In XAML Toolkit !Logo of Material Design in XAML




![NuGet-Themes-CI)](https://www.nuget.org/packages/MaterialDesignThemes/)
![NuGet-Colors-CI)](https://www.nuget.org/packages/MaterialDesignColors/)

 
 
![Chat][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


  Table of contents

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



---

 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

xml

    
        
            
                

                 
            
        
    


 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

xml



 XML Namespaces

The toolkit exposes two XML namespaces for use in XAML:

| Prefix | URI | Description |
|--------|-----|-------------|
| materialDesign | http://materialdesigninxaml.net/winfx/xaml/themes | Primary namespace for all public Material Design types, controls, and converters. |
| materialDesignInternal | http://materialdesigninxaml.net/winfx/xaml/themes-internal | Namespace for types in internal sub-namespaces (MaterialDesignThemes.Wpf.Internal, MaterialDesignThemes.Wpf.Converters.Internal, MaterialDesignThemes.Wpf.Behaviors.Internal). |

 [!WARNING]
 Types exposed via the materialDesignInternal namespace are considered internal implementation details and are not guaranteed to maintain backwards-compatibility between versions. Use them at your own risk.

To use the internal namespace in XAML:

xml




 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


  Material Design 3 demo app screenshots

  !Buttons
  !Cards
  !Chips