Windows UI Library
The Windows UI Library (WinUI) provides official native Microsoft UI controls and features for Windows UWP apps.
WinUI is the easiest way to build great Fluent Design experiences for Windows.
WinUI can be used in any Windows 10 UWP XAML app, or in a Xamarin.Forms app running on Windows 10 using native view embedding.
🍕 Achievement unlocked: 1000 Contributions! 🍕
We recently hit our 1000th community contribution! (#1000 by @eugenegff) This is a wonderful milestone for WinUI. To celebrate, on July 26th we’ll randomly draw 10 people from the community that follow/contribute to our repo. These 10 people will receive a small special thank you gift. Make sure you’re watching our repo to be included in the draw on the 26th!
WinUI 3.0 Announcement
At the Microsoft Build conference in May 2019 we shared our plans for WinUI 3.0, which will greatly expand the scope of WinUI to include the full native Windows UI platform.
For more info check out the updated roadmap and join the discussion in the 3.0 discussion issue.
Using WinUI
You can download and use WinUI packages in your app using the NuGet package manager: see the Getting Started with the Windows UI Library page for more information.
Packages
| NuGet Package | Build Status | Latest Versions | Documentation |
|---|---|---|---|
| Microsoft.UI.Xaml Controls and Fluent Design for UWP apps |
  |
2.1 release | |
| Microsoft.UI.Xaml.Core.Direct Low-level APIs for middleware components |
 |
2.0 prerelease |
You can also build a WinUI package yourself from source. See Contributing to the Windows UI Library for more information on building and contributing to WinUI.
Documentation
WinUI usage documentation:
https://docs.microsoft.com/uwp/toolkits/winui
Release notes:
https://docs.microsoft.com/uwp/toolkits/winui/release-notes/
Sample code:
To view the WinUI controls in an interactive format, check out the Xaml Controls Gallery:
- Get the XAML Controls Gallery app from the Microsoft Store
- Get the source code on GitHub
Contributing to WinUI
The WinUI team welcomes feedback and contributions!
For information on how to contribute please see Contributing to the Windows UI Library.
WinUI features
Benefits
The WinUI Library provides some useful benefits when building apps for Windows 10:
-
Helps you stay up to date
WinUI helps keep your app up to date with the latest versions of key controls and features of UWP XAML and the Fluent Design System -
Provides backward compatibility
WinUI is backward-compatible with a wide range of Windows 10 versions: you can start building and shipping apps with new XAML features immediately as soon as they're released, even if your users aren't on the latest version of Windows 10 -
Makes it simpler to build version adaptive apps
You don't need version checks or conditional XAML markup to use WinUI controls or features: WinUI automatically adapts to the user's OS version
Version support
The Microsoft.UI.Xaml 2.2 NuGet package requires your project to have TargetPlatformVersion >= 10.0.18362.0 and TargetPlatformMinVersion >= 10.0.15063.0 when building.
Your app's users can be on any of the following supported Windows versions:
- Windows Insider Previews
- May 2019 Update (18362 aka "19H1")
- October 2018 Update (17763 aka "Redstone 5")
- April 2018 Update (17134 aka "Redstone 4")
- Fall Creators Update (16299 aka "Redstone 3")
- Creators Update (15063 aka "Redstone 2")
Some features may have a reduced or slightly different user experience on older versions, particularly on builds before 15063. This should not impact overall usability.
Roadmap
For info on the WinUI release schedule and high level plans please see the Windows UI Library Roadmap.
Data/Telemetry
This project collects usage data and sends it to Microsoft to help improve our products and services. Read Microsoft's privacy statement to learn more.
For more information on telemetry implementation see the developer guide.