Skip to content
Windows UI Library: the latest Windows 10 native controls and Fluent styles for your applications
Branch: master
Clone or download
kaiguo Fix TreeViewItem left padding (#438)
* Collapse text border

* Fix CheckBox rectangle alignment

* Fix test
Latest commit 4ececc3 Mar 16, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update feature request issue template (#191) Jan 17, 2019
.vscode Add basic VSCode browse and intellisense configuration (#345) Feb 25, 2019
build update sdk iso url (#420) Mar 13, 2019
dev
docs Turning off Microsoft Telemetry collection in private builds. (#387) Mar 8, 2019
idl Fix visibility and namespace of a couple AutomationPeer types (#331) Feb 21, 2019
manifest Initial commit Dec 4, 2018
test Support visualtree verification for Controls (#126) Mar 15, 2019
tools
winrt Initial commit Dec 4, 2018
.editorconfig Initial commit Dec 4, 2018
.gitattributes
.gitignore
Build.cmd
CODE_OF_CONDUCT.md Initial commit Dec 4, 2018
CONTRIBUTING.md Developer Guide doc updates (#277) Feb 14, 2019
CustomInlineTasks.targets Initial commit Dec 4, 2018
CustomTasks.sln
DevCmd.cmd Update DevCmd script to use VSWhere (#314) Feb 15, 2019
Directory.Build.props
LICENSE Initial commit Jul 26, 2018
MUXControls.sln Support visualtree verification for Controls (#126) Mar 15, 2019
ProjectConfigurations.props
README.md
RunTests.ps1 Fix issue with machine having test app installed but with different a… Dec 21, 2018
SdkVersion.props
custom.props Update version to 2.1 (#75) Dec 13, 2018
dirs Initial commit Dec 4, 2018
environment.props Turning off Microsoft Telemetry collection in private builds. (#387) Mar 8, 2019
mux.controls.props
nuget.config

README.md

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.

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
Microsoft.UI.Xaml
Controls and Fluent Design for UWP apps
Build Status latest stable version
latest prerelease version
Microsoft.UI.Xaml.Core.Direct
Low-level APIs for middleware components
latest prerelease version

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 can be found here:

https://docs.microsoft.com/uwp/toolkits/winui

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

The WinUI Library 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 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.

Contents

The Microsoft.UI.Xaml 2.0 stable package includes:

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

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.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.