Windows UI Library
The Windows UI Library (WinUI) is a set of open source Microsoft UI controls and features for the Windows UWP platform.
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.
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.
|NuGet Package Name||Description|
|Microsoft.UI.Xaml||Controls and features for building apps for Windows 10|
|Microsoft.UI.Xaml.Core.Direct||Low-level APIs for creating middleware components. Not intended or required for general application use|
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.
WinUI usage documentation can be found here:
Contributing to WinUI
The WinUI team welcomes feedback and contributions!
For information on how to contribute please see Contributing to the Windows UI Library.
The WinUI Library provides some useful benefits when building apps for Windows 10:
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
The Microsoft.UI.Xaml NuGet package requires your project to have TargetPlatformVersion >= 10.0.17134.0 and TargetPlatformMinVersion >= 10.0.14393.0 when building.
Your app's users can be on any of the following supported Windows versions:
- Windows Insider Previews
- October 2018 Update (17763)
- April 2018 Update (17134)
- Fall Creators Update (16299)
- Creators Update (15063)
- Anniversary Update (14393)
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.
The Microsoft.UI.Xaml 2.0 stable package includes:
- Fluent Design control styles for all XAML controls (from both WinUI and the standard Windows 10 SDK)
- Fluent materials and styles including Fluent Acrylic and Fluent Reveal
- Many new and popular controls like ColorPicker, MenuBar, NavigationView, ParallaxView, PersonPicture, RatingControl, RefreshContainer, SplitButton, SwipeControl, and TreeView
Prerelease Microsoft.UI.Xaml packages also include previews of features and controls that we are still working on, like:
The Microsoft.UI.Xaml.Core.Direct package includes:
- XamlDirect and related APIs to improve performance for middleware components
For info on schedules and plans please see the high level plans see the Windows UI Library Roadmap.
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.