readme.md

WinUI 3 Desktop Apps

We're looking into adding WinUI 3 Desktop App templates to Windows Template Studio.

Our templates for WinUI 3 Desktop Apps are currently in preview as WinUI3 itself. You can try them out in our dev-nightly version.

We would love to get your feedback on our tracking issue for WinUI3 templates.

If you miss anything or find an issue that is not mentioned in the known issues section please file a new issue.

Prerequisites

1. Ensure that your development computer has Windows 10, version 1803 (build 17134), or newer installed.

2. Install Visual Studio 2019, version 16.9 Preview. You must include the following workloads when installing Visual Studio:

   • .NET Desktop Development (this also installs .NET 5)
   • Universal Windows Platform development

3. Make sure your system has a NuGet package source enabled for nuget.org. For more information, see Common NuGet configurations

4. Add a new Package source to the Windows Community DevOps feed:

   • Go to Tools -> NuGet Package Manager -> Package Manager Settings -> Package Sources
   • Add a new Package Source for https://pkgs.dev.azure.com/dotnet/WindowsCommunityToolkit/_packaging/WindowsCommunityToolkit-WinUI3/nuget/v3/index.json
   • Confirm by clicking update, then Ok

Known issues:

• Windows Default theme issue
• Dark/Light theme issue
• Master/Detail Issue with WinUI
• Localized tooltips issue
• Localized automation name issue
• WebView2 exception
• VisualStateManager initializarion issue

Additional docs:

• Windows UI Library 3 Preview 4 (November 2020)
• Windows UI Library on GitHub
• Windows Community Toolkit 8.0.0-preview4 for WinUI 3 Preview 4