A toolkit for creating Metro / Modern UI styled WPF apps.
C#

readme.md

MahApps.Metro

A toolkit for creating metro-style WPF applications. Lots of goodness out-of-the box.

Gitter

StackExchange

Release NuGet NuGetPre Issues

TeamCity TeamCity

Want to say thanks?

Hit the ⭐️ Star ⭐️ button, thx :shipit:

Documentation

You can read the documentation on the web site: http://mahapps.com
You can also help keep the documentation up to date by submitting a pull request on the mahapps.github.com repository. If you're unfamiliar with GitHub Pages, the help guides here are a good place to start.

maindemowindow01

maindemowindow02

maindemowindow03

maindemowindow03

maindemowindow04

Release Notes

Icons

MahApps.Metro can use the MahApps.Metro.IconPacks to use some awesome stylish and handmade icons for better cool applications.

iconbrowserfinal

<iconPacks:PackIconMaterial Kind="EmoticonCool" />

2016-07-26_02h28_22

<iconPacks:PackIconModern Kind="ThumbsUp" />

2016-07-26_02h28_37

<iconPacks:PackIconFontAwesome Kind="FontAwesome" />

2016-07-26_02h29_35

<iconPacks:PackIconEntypo Kind="EmojiHappy" />

2016-07-26_02h30_11

It's still possible to use the old Xaml icon resources available here (but you should use the new one for easier usage).

Contributing to this project

Did you stumble upon a bug? Before reporting it to us, please check out the FAQ to see if it is actually a bug. If you can not find anything related to your issue, feel free to report it to us in the issue tracker.

If you've improved MahApps.Metro and think that other people would enjoy it, submit a pull request. Anyone and everyone is welcome to contribute.

Please take a moment to review the guidelines for contributing.

You need Visual Studio 2015 Community Edition to build the solution (comes with #2330), so we can use the new C# 6 features. You can use the dev-vc2013 branch if you still have the Visual Studio 2013, but no new feature or fix will be added in this branch by me™.

Styles

CheckBox and RadioButton styles adapted from styles created by Brian Lagunas of Infragistics.

Missing a control?

If you're looking for a control that we don't have, we have some friends who have made MA.M compatible controls. Check them out:

A short How To

Or, how to create a simple MahApps.Metro Application and a Window...

<Application x:Class="WpfApplication.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Controls.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Fonts.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Colors.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/Blue.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/BaseLight.xaml" />
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>
<controls:MetroWindow x:Class="WpfApplication.MainWindow"
                      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                      xmlns:controls="http://metro.mahapps.com/winfx/xaml/controls"
                      Title="MainWindow"
                      Height="600"
                      Width="800">
  <Grid>

    <!-- your content -->

  </Grid>
</controls:MetroWindow>
namespace WpfApplication
{
  public partial class MainWindow : MetroWindow
  {
    public MainWindow()
    {
      InitializeComponent();
    }
  }
}

Awesome tools which MahApps can use

TeamCity Resharper

Visual Studio Templates

MahApps.Metro have 4 simple templates to start with the awesome MahApps.Metro library.

  • WPF MahApps.Metro Application (.NET4)
  • WPF MahApps.Metro Application (.NET45)
  • Visual Basic WPF MahApps.Metro Application (.NET45)
  • Window MahApps.Metro (WPF)

Download this Templates.zip (templates are created with VS 2013) and extract it to your user template folder:

c:\Users\<USER>\Documents\Visual Studio 201x\

Now you can choose the templates at the New Project dialog.

Breaking Changes

Licence

MIT License (MIT)