WinUI is the modern native UI platform for Windows with two active generations:
-
WinUI 3: The latest, 3rd generation of WinUI that ships the entire WinUI stack decoupled from the operating system as a part of the Windows App SDK.
-
WinUI 2: The previous generation of the WinUI stack for UWP apps, consisting of a XAML and Visual Layer built directly into the Windows 10 operating system, and a controls library built on top of the OS, delivered via NuGet, and hosted at this repository. WinUI 2 will continue to be supported with bug, reliability, and security fixes.
**For a detailed look on the difference between WinUI 2 & 3, please view our comparison table
WinUI provides a number of benefits which makes it the best way to create user interfaces for Windows apps:
-
The native UI platform of Windows
WinUI is the highly-optimized native UI platform used to create Windows itself, now made more broadly available for all developers to use to reach Windows. It's a thoroughly tested and proven UI platform that powers the operating system environment and essential experiences of 1 billion+ Windows 10 & 11 PC, XBox One, HoloLens, Surface Hub and other devices. -
The latest advancements in Fluent Design
WinUI is Microsoft's main focus for native, accessible Windows UI and controls and is the definitive source for the Fluent Design System on Windows.
It will also support the latest composition and rendering innovations like vector animations, effects, shadows and lighting. -
Backward compatibility for new features
New WinUI features will continue to be backward-compatible with a wide range of Windows 10 and 11 versions. With WinUI 3, you can start building and shipping apps with new features immediately as soon as they're released, without having to wait for your users to be running the latest update of Windows. -
Native development support
WinUI can be used with .NET, but doesn't depend on .NET: WinUI is 100% C++ and can be used in unmanaged Windows apps, for example using standard C++17 via C++/WinRT. -
More frequent updates
WinUI is planned to ship roughly every 6 months, with at least two preview builds per stable release. This is more of a guideline than a rule, but that is what the team strives for. -
Open source development and community engagement
The WinUI 2 Controls Library is already open source on GitHub, and we're planning to add the full WinUI 3 framework into this repo as well. You can engage directly with Microsoft's core engineering team and contribute bug reports, feature ideas, and even code: see the Contribution Guide for more info. You can also try out the pre-release builds to see new in-development features and help shape their final form.
WinUI 3 is the latest generation of native Windows UI, consisting of all the major UX layers of Windows decoupled and shipping as a standalone solution for you to use.
It focuses on enabling three main use cases:
- Modernizing existing apps
- Enabling you to extend existing Win32 (WPF, WinForms, MFC...) apps with modern Windows UI at your own pace using the upcoming release of Xaml Islands. Developers who currently use WinUI 2 for their app UX will be able to easily move to WinUI 3, as their syntax and capabilities are very similar
- Creating new Windows apps
- Enabling you to easily create new modern Windows apps with the flexibility offered by the Windows App SDK
- Enabling other frameworks
- Providing the native implementation for other frameworks like React Native and .NET MAUI when running on Windows.
WinUI 3 is available as a part of the Windows App SDK for building stable and supported desktop/Win32 apps for production scenarios. The latest release is the Windows App SDK 1.1, which you can download and read more about at the documentation linked below:
Stable release channel for the Windows App SDK
We also ship experimental features as we develop them. You can read more about the Windows App SDK Experimental releases at the following documentation. Note that Experimental releases have limitations and known issues, so they are not equipped for production apps.
Experimental release channel for the Windows App SDK.
Legend:
🟢 - Available as supported feature
🔷 - Available as experimental feature
Blank - Not available
WinUI 3 - Windows App SDK 1.1 is our latest release. For a detailed look at the features we're targeting in WinUI 3 in 2022, check out the Windows App SDK feature roadmap.
| Customer Capability | Project Reunion 0.5 (March 2021) |
Windows App SDK 0.8 (June 2021) |
Windows App SDK 1.0 (November 2021) |
Windows App SDK 1.1 (June 2022) |
|---|---|---|---|---|
| Supported in any app using the Windows App SDK | 🟢 | 🟢 | 🟢 | 🟢 |
| Contains new Windows 11 controls/styles from WinUI 2.6 | 🟢 | 🟢 | ||
| Supports MSIX Deployment | 🟢 | 🟢 | 🟢 | 🟢 |
| Supports Unpackaged (non-MSIX) Deployment | 🟢 | 🟢 | ||
| Works downlevel to Windows 10 version 1809 and above | 🟢 | 🟢 | 🟢 | 🟢 |
| Supports the latest .NET | 🟢 | 🟢 | 🟢 | 🟢 |
| ARM64 support | 🟢 | 🟢 | 🟢 | 🟢 |
<SwapChainPanel> |
🟢 | 🟢 | 🟢 | 🟢 |
| Intellisense, Hot Reload, Live Visual Tree | 🔷 | 🔷 | 🟢1 | 🟢1 |
| Chromium-based WebView2 | 🟢 | 🟢 | 🟢 | 🟢 |
| Title bar customization | 🟢 | 🟢 | 🟢 | 🟢 |
| Fluent Shadows | 🟢 | 🟢 | 🟢 | 🟢 |
| Input validation for data fields | 🔷 | 🔷 | 🔷 | 🔷 |
| Supports multiple top-level windows on the same thread | 🔷 | 🔷 | 🟢2 | 🟢 |
| Supports multiple top-level windows on separate threads | 🔷 | 🔷 | 🔷 | 🔷 |
| Drag and drop | 🟢 | 🟢 | 🟢 | 🟢 |
| RenderTargetBitmap | 🟢 | 🟢 | 🟢 | 🟢 |
| Mouse cursor customization | 🟢 | 🟢 | 🟢 | 🟢 |
| Animated Gif support | 🟢 | 🟢 | 🟢 | 🟢 |
| VirtualSurfaceImageSource (VSIS) support | 🟢 | 🟢 | 🟢 | 🟢 |
| In-app acrylic | 🟢 | 🟢 | 🟢 | 🟢 |
| XAML Islands | 🔷 | 🔷 | 🔷 | |
| Mica | 🟢 |
WinUI 2 is a native user experience (UX) framework for both Windows desktop and UWP applications tightly integrated with Windows 10 and above SDKs.
The next release of the WinUI 2 Controls Library will be v2.8, aiming to release in mid-2022.
WinUI 2.8 will include WebView2 & bug, reliability, and security fixes for UWP apps. You can find a list of currently planned work in the WinUI 2.8 milestone.
For installation instructions see Getting started with the Windows UI Library.