/WindowsCommunityToolkit

The Windows Community Toolkit is a collection of helpers, extensions, and custom controls. It simplifies and demonstrates common developer tasks building .NET apps with UWP and the Windows App SDK / WinUI 3 for Windows 10 and Windows 11. The toolkit is part of the .NET Foundation.

Primary LanguageC#OtherNOASSERTION

✨ New Repository ✨

❗ We moved development to a new repository, 'Windows'. It contains the new infrastructure and codebase for the 8.0+ versions of the Windows Community Toolkit that contains a single-codebase for UWP/WinUI2, WindowsAppSDK/WinUI3, and Uno Platform compatible components. Please visit it for the latest information.

📝 You can find out more about this latest release on our blog post here. The Sample Gallery has also been updated in the Microsoft Store.

🧪 For new feature discussion and development, see Windows Community Toolkit Labs

🐞 For new issues, please try and reproduce on the latest packages, and then open a discussion or issue in the new repository.

📼 This repo contains the prior 7.x UWP-only based code for the Windows Community Toolkit's prior releases; the Windows App SDK compatible code is in the winui branch. Much of this code has been merged and ported to the single-codebase version in the new repository; however, this repo will be archived for history and reference to enable migrating other components or issues, if needed.

🧰 Windows Community Toolkit 7.x

The Windows Community Toolkit is a collection of helper functions, custom controls, and app services. It simplifies and demonstrates common developer patterns when building experiences for Windows 10 and Windows 11. It contains components and helpers for both UWP and WinUI 3/WinAppSDK applications. Find out more about our support for WinUI 3 here.

Note: Our general helpers for .NET are now the .NET Community Toolkit, including the MVVM Toolkit.

Target Branch Status Recommended package version
Production (UWP) rel/7.1.2 Build Status NuGet
Production (WinAppSDK/WinUI 3) rel/winui/7.1.2 Build Status NuGet
Previews main Build Status DevOps

📢 Windows Community Toolkit v8

The toolkit has been migrated to new infrastructure in this repository.

Read the original blog post that explained this here, but see latest information at the top of this file.

🧪 Windows Community Toolkit Labs 💻

Labs makes it easy to contribute to the Windows Community Toolkit, try out new features still in development, and collaborate with others.

Find out more here.

🙌 Getting Started

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

📃 Documentation

All documentation for the toolkit is hosted on Microsoft Docs. All API documentation can be found at the .NET API Browser.

📱 Windows Community Toolkit Sample App

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

⁉ Support

If you need help with something or have an idea, feel free to start a Discussion or find us on Discord. If you have detailed repro steps, open an issue here instead.

🚀 Contribution

Do you want to contribute? Check out our Windows Community Toolkit Wiki page to learn more about contribution and guidelines.

📦 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… Enter one of the package names mentioned in Windows Community Toolkit NuGet Packages table to search for it online.

📫 Features

The Features list refers to all the currently available features that can be found in the Windows Community Toolkit. 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 be kept simple.
  2. As soon as a comparable feature is available in the Windows SDK for Windows, it will be marked as deprecated.
  3. All features will be supported for two Windows SDK for Windows release cycles or until another principle supersedes it.

🌍 Roadmap

See our 2022 Plans here.

Read what we plan for next iterations, and feel free to ask questions.

Check out our Preview Packages Wiki Page to learn more about updating your NuGet sources in Visual Studio, then you can also get pre-release packages of upcoming versions to try.

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