.github | ||
build | ||
CommunityToolkit.Common | ||
CommunityToolkit.Diagnostics | ||
CommunityToolkit.HighPerformance | ||
CommunityToolkit.Mvvm | ||
CommunityToolkit.Mvvm.SourceGenerators | ||
tests | ||
.editorconfig | ||
.git-blame-ignore-revs | ||
.gitattributes | ||
.gitignore | ||
.runsettings | ||
azure-pipelines.yml | ||
CODE_OF_CONDUCT.md | ||
Contributing.md | ||
Directory.Build.props | ||
Directory.Build.targets | ||
dotnet Community Toolkit.sln | ||
License.md | ||
README.md | ||
ThirdPartyNotices.txt | ||
toolkit.snk | ||
version.json |
🧰 .NET Community Toolkit
.NET Community Toolkit is a collection of helpers and APIs that work for all .NET developers and are agnostic of any specific UI platform. The toolkit is maintained and published by Microsoft, and part of the .NET Foundation.
Target | Branch | Status | Recommended package version |
---|---|---|---|
Production | rel/7.1.2 | ||
Previews | main |
👀 What does this repo contain?
This repository contains several .NET libraries (originally developed as part of the Windows Community Toolkit) that can be used both by application developers (regardless on the specific UI framework in use, they work everywhere!) and library authors. These libraries are also being used internally at Microsoft to power many of our first party apps (such as the new Microsoft Store) and constantly improved by listening to feedbacks from other teams, external partners and other developers from the community. Here's a quick breakdown of the various components you'll find in this repository:
CommunityToolkit.Mvvm
(aka MVVM Toolkit): a fast, modular, platform-agnostic MVVM library, which is the official successor ofMvvmLight
. It's used extensively in the Microsoft Store and other first party apps.CommunityToolkit.Mvvm.SourceGenerators
: the source generators to augment the MVVM Toolkit.CommunityToolkit.Diagnostics
: a set of helper APIs (specifically,Guard
andThrowHelper
) that can be used for cleaner, more efficient and less error-prone argument validation and error checking.CommunityToolkit.HighPerformance
a collection of helpers for working in high-performance scenarios. It includes APIs such as pooled buffer helpers, a fast string pool type, a 2D variant ofMemory<T>
andSpan<T>
(Memory2D<T>
andSpan2D<T>
) also supporting discontiguous regions, helpers for bit shift operations (such asBitHelper
, also used in Paint.NET), and more.CommunityToolkit.Common
: a set of helper APIs shared with other CommunityToolkit libraries.
🙌 Getting Started
Please read the Getting Started with the .NET Community Toolkit page for more detailed information.
📃 Documentation
All documentation for the toolkit is hosted on Microsoft Docs.
All API documentation can be found at the .NET API Browser.
🚀 Contribution
Do you want to contribute?
Check out our .NET 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 .NET Community Toolkit NuGet Packages table to search for it online.
🌍 Roadmap
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
Made with contrib.rocks.