Skip to content
Windows UI Library: the latest Windows 10 native controls and Fluent styles for your applications
C# C++ PowerShell Other
Branch: master
Clone or download

Latest commit

Latest commit 0986935 May 28, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update bug_report.md (#2473) May 19, 2020
.vscode Change from insider SDK to public 18362 SDK (#651) May 7, 2019
build Update Helix SDK (#2557) May 28, 2020
dev Make TreeView SelectedItem a DP (#2523) May 28, 2020
docs Removing VB.NET support from the roadmap (#2526) May 27, 2020
idl Fix IsInFrameworkPackage logic (#1762) Dec 16, 2019
localpackages Enable incremental builds to pick up changes in xaml files. (#1067) Jul 17, 2019
test Update Helix SDK (#2557) May 28, 2020
tools Update build script to add new projects to solutions (#2145) Apr 3, 2020
.editorconfig Re-enable code analysis and fix some CppCoreGuidelines checks (#1661) Dec 6, 2019
.gitattributes Initial commit Dec 4, 2018
.gitignore Move radio buttons onto repeater (#1623) Nov 23, 2019
Build.cmd Stubbing out MicrosoftTelemetry.h and modifying build to swap in real… Nov 18, 2019
CODE_OF_CONDUCT.md Initial commit Dec 4, 2018
CONTRIBUTING.md Add repo security policy & update contributor guide (#1312) Sep 11, 2019
CreateTestBinariesDirFromBuild.ps1 Multiple test-pass reliability fixes (#2207) Apr 3, 2020
CustomInlineTasks.targets Initial commit Dec 4, 2018
CustomTasks.sln Initial commit Dec 4, 2018
DevCmd.cmd Update DevCmd script to use VSWhere (#314) Feb 15, 2019
Directory.Build.props Initial commit Dec 4, 2018
FeatureAreas.props Improve innerloop workflow (#2238) Apr 7, 2020
InnerLoopAreas.props Improve innerloop workflow (#2238) Apr 7, 2020
LICENSE Initial commit Jul 26, 2018
MUXControls.sln Remove adhoc app (#2334) Apr 24, 2020
MUXControlsInnerLoop.sln Improve innerloop workflow (#2238) Apr 7, 2020
PGO.compile.props Produce and consume appropriate PGO database versions (#1936) Feb 6, 2020
PGO.runtime.props initial Jan 28, 2020
ProjectConfigurations.props Initial commit Dec 4, 2018
README.md Updating reference to WinUI 2.4 release webpage (#2501) May 27, 2020
RunTestsOnTShellConnectedDevice.ps1 Script to create local test binaries from Azure Pipelines build (#914) Jun 22, 2019
SdkVersion.props Change from insider SDK to public 18362 SDK (#651) May 7, 2019
environment.props Stubbing out MicrosoftTelemetry.h and modifying build to swap in real… Nov 18, 2019
mux.controls.props Fixing CalendarDatePicker's template (#881) Jun 27, 2019
nuget.config Update Helix SDK (#2557) May 28, 2020
privacy.md Update privacy notice (#1140) Aug 9, 2019
version.props Update nuget version information to 2.5 (#2413) May 13, 2020

README.md

Windows UI Library

Follow WinUI on Twitter

WinUI is a user interface layer that contains modern controls and styles for building Windows apps. As the native UI layer in Windows it embodies Fluent Design, giving each Windows app the polished feel that customers expect.

WinUI 2 is a library of controls that provides official native Microsoft UI controls and features for Windows UWP apps. WinUI 2 can be used in any Windows 10 UWP XAML app, or in a Xamarin.Forms app running on Windows 10 using native view embedding.

WinUI 3 is the next version of the WinUI framework, shipping later this year. It dramatically expands WinUI into a full UX framework, making WinUI available for all types of Windows apps – from Win32 to UWP – for use as the UI layer.

WinUI Community Calls

The WinUI community call is your monthly opportunity to learn about native UX development for Windows with WinUI.

In these calls we’ll discuss the WinUI roadmap, our status and your feedback.

You can watch them online here on YouTube at the Windows Developer channel.

Add the event to your calendar: ICS calendar file

WinUI 3.0 Alpha (February 2020)

As outlined in the roadmap we're currently working on WinUI 3.0, which will greatly expand the scope of WinUI to include the full native Windows UI platform.

You can now download an early build of WinUI 3.0 Alpha to try out - we'd love your feedback!

For more info see the discussion issue #1965.

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
Build Status latest stable version
latest prerelease version
2.4 release
Microsoft.UI.Xaml.Core.Direct
Low-level APIs for middleware components
latest prerelease version 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:

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

WinUI 2 provides some useful benefits when building apps for Windows 10:

  1. 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

  2. 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

  3. 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.3 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 10 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. See the privacy statement for more details.

For more information on telemetry implementation see the developer guide.

You can’t perform that action at this time.