View on GitHub


Windows Modern UI for .NET WinForms Applications

Download from NuGet Download this project as a tar.gz file

Add a fresh look to your .NET WinForms application with controls using the Modern 'Metro' UI theme of Windows 8.

This work is based on software from the winforms-modernui project. Changes and additions include:

Some of the changes have been back-ported by the original author but are incomplete or have been broken due to his silly renaming and refactoring policies. When he also insisted on deleting ALL documentation, I decided to fork the project.

Getting started

Once you have installed the software, add a reference to MetroFramework.dll and MetroFramework.Design.dll. The latter is for design-time support and doesn't need to be deployed, i.e. you should set the "Copy Local" property to false.

Due to the non-intrusive installation procedure, support for creating your first form isn't optimal. The recommended procedure is to add a new "Windows Form" to your project. Then press F7 to switch into code view and change the base class from "Form" to "MetroFramework.Forms.Form". Switch back to design view and you should be able to add more MetroFramework controls from the Toolbox as usual.


It is recommended to install MetroFramework using NuGet, as this will give you release builds and automatic updates. In Visual Studio, right-click on your project in Solution Explorer and choose "Manage NuGet packages...". Then "Search Online" for "MetroFramework" and install the "MetroFramework Installer". The installer will pull-in all required dependencies, i.e. there is no need to install other packages manually.

To install the packages using the NuGet shell, simply type the below:

Install-Package MetroFramework

More information about the NuGet packages:

If you like living on the edge, download the latest source code or clone the project on Git Hub.

Supported Platforms

Windows XP and later, incl. Windows 8


.NET Framework 4.0 (Client Profile) and later.




MetroFramework comes with two stock themes, Light and Dark. These themes are complimented by a selection of style colors to allow further customization. You can easily add your own themes (seee themes.xml).





(Image source:


Copyright (c) 2013 Jens Thiel,

This Software is licensed under the MIT (new) license. See LICENSE for details.