/Windows

Collection of controls for WinUI 2, WinUI 3, and Uno Platform developers. Simplifies and demonstrates common developer tasks building experiences for Windows with .NET.

Primary LanguageC#OtherNOASSERTION

Windows Community Toolkit 🧰

Windows Community Toolkit Labs Social Image

Welcome to the home of Windows Community Toolkit. Our components are built on top of WinUI 2, WinUI 3, and Uno Platform!

They enable developers to build great experiences for Windows with .NET!

Building something cool? Want to engage with other developers? Want to contribute to the Toolkit? Engage in the discussion here!

Getting Started

Want to see the toolkit in action before jumping into the code? Download and play with the Windows Community Toolkit Gallery from the Store.

Please read the Getting Started with the Windows Community Toolkit page for more detailed information about using the toolkit.

Windows Community Toolkit Labs

Have an idea for a new feature? Want to checkout the latest things being built. Then head over to Windows Community Toolkit Labs.

You can even see the latest components live in your browser!

Clone the repository

The tooling is in a submodule, so you'll need to use --recurse-submodules when cloning or pulling for the first time:

git clone --recurse-submodules https://github.com/CommunityToolkit/Windows.git

Build Requirements

  • Visual Studio 2022 (UWP & Desktop Workloads for .NET)
  • .NET 6 SDK
  • Windows App SDK
  • Windows SDK 19041

πŸš€ Contribution

We're always looking for a helping hand, look for issues that we need help with here or head over to Windows Community Toolkit Labs to try or build new features.

Even just improving our docs and samples for existing components here, or adding new tests can be a huge help!

Check out our Windows Community Toolkit Wiki page to learn more about contribution and guidelines in general (to be updated more soon).

πŸ“¦ NuGet Packages

NuGet is a standard package manager for .NET applications which is built into Visual Studio. When you open solution in Visual Studio, choose the Tools menu > NuGet Package Manager > Manage NuGet packages for solution…

There are now two sets of packages for each component:

  • CommunityToolkit.Uwp.* for UWP + WinUI 2 or Uno.UI
  • CommunityToolkit.WinUI.* for Windows App SDK + WinUI 3 or Uno.WinUI

πŸ“« Features

Most features should work with the October 2018 Update (1809) SDK 17763 and above; however, refer to specific documentation on each feature for more information.

πŸ’  Principles

  1. The toolkit will provide features that are needed for a wide-array of developers, are easy-to-use, and maintainable.
  2. As soon as a comparable feature is available in the Windows SDK for Windows, it will be marked as deprecated.
  3. We will fix issues forward and stay up-to-date on top of WinUI 2 and 3 updates supporting the minimum OS level that they also support.

πŸ“„ Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

🏒 .NET Foundation

This project is supported by the .NET Foundation.

πŸ† Contributors

Toolkit Contributors

Made with contrib.rocks.