CommunityToolkit.WinUI.Controls.Primitives
                               
                            
                                8.2.250402
                            
                        
                            
                                
                                
                                    Prefix Reserved
                                
                            
                    dotnet add package CommunityToolkit.WinUI.Controls.Primitives --version 8.2.250402
NuGet\Install-Package CommunityToolkit.WinUI.Controls.Primitives -Version 8.2.250402
<PackageReference Include="CommunityToolkit.WinUI.Controls.Primitives" Version="8.2.250402" />
<PackageVersion Include="CommunityToolkit.WinUI.Controls.Primitives" Version="8.2.250402" />
<PackageReference Include="CommunityToolkit.WinUI.Controls.Primitives" />
paket add CommunityToolkit.WinUI.Controls.Primitives --version 8.2.250402
#r "nuget: CommunityToolkit.WinUI.Controls.Primitives, 8.2.250402"
#:package CommunityToolkit.WinUI.Controls.Primitives@8.2.250402
#addin nuget:?package=CommunityToolkit.WinUI.Controls.Primitives&version=8.2.250402
#tool nuget:?package=CommunityToolkit.WinUI.Controls.Primitives&version=8.2.250402
Windows Community Toolkit - Primitives
This package is part of the Windows Community Toolkit from the .NET Foundation.
Package Contents
This package contains the following controls in the CommunityToolkit.WinUI.Controls namespace:
- ConstrainedBox
 - DockPanel
 - StaggeredLayout
 - StaggeredPanel
 - SwitchPresenter
 - UniformGrid
 - WrapLayout
 - WrapPanel
 
Which Package is for me?
If you're developing with UWP/WinUI 2 or Uno.UI you should be using the CommunityToolkit.Uwp.Controls.Primitives package.
If you're developing with WindowsAppSDK/WinUI 3 or Uno.WinUI you should be using the CommunityToolkit.WinUI.Controls.Primitives package.
WinUI Resources (UWP)
For UWP projects, the WinUI 2 reference requires you include the WinUI XAML Resources in your App.xaml file:
    <Application.Resources>
        <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" />
    </Application.Resources>
See Getting Started in WinUI 2 for more information.
Documentation
Further documentation about these components can be found at: https://aka.ms/windowstoolkitdocs
License
MIT
See License.md in package for more details.
| Product | Versions Compatible and additional computed target framework versions. | 
|---|---|
| .NET | net7.0-windows10.0.18362 is compatible. net8.0-windows was computed. net8.0-windows10.0.18362 is compatible. net8.0-windows10.0.19041 is compatible. net9.0 is compatible. net9.0-android was computed. net9.0-android35.0 is compatible. net9.0-browser was computed. net9.0-ios was computed. net9.0-ios18.0 is compatible. net9.0-maccatalyst was computed. net9.0-maccatalyst18.0 is compatible. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net9.0-windows10.0.18362 is compatible. net9.0-windows10.0.19041 is compatible. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. | 
- 
                                                    
net8.0-windows10.0.19041
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Microsoft.WindowsAppSDK (>= 1.6.250108002)
 
 - 
                                                    
net9.0
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Uno.Fonts.Fluent (>= 2.4.5)
 - Uno.WinUI (>= 5.5.87)
 
 - 
                                                    
net9.0-android35.0
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Uno.Fonts.Fluent (>= 2.4.5)
 - Uno.WinUI (>= 5.5.87)
 
 - 
                                                    
net9.0-ios18.0
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Uno.Fonts.Fluent (>= 2.4.5)
 - Uno.WinUI (>= 5.5.87)
 
 - 
                                                    
net9.0-maccatalyst18.0
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Uno.Fonts.Fluent (>= 2.4.5)
 - Uno.WinUI (>= 5.5.87)
 
 - 
                                                    
net9.0-windows10.0.19041
- CommunityToolkit.WinUI.Extensions (>= 8.2.250402)
 - Microsoft.WindowsAppSDK (>= 1.6.250108002)
 
 
NuGet packages (7)
Showing the top 5 NuGet packages that depend on CommunityToolkit.WinUI.Controls.Primitives:
| Package | Downloads | 
|---|---|
| 
                                                        
                                                            CommunityToolkit.WinUI.Controls.TokenizingTextBox
                                                        
                                                            
                                                         A text input control that auto-suggests and displays token items.  | 
                                                    |
| 
                                                        
                                                            CommunityToolkit.WinUI.Controls.ColorPicker
                                                        
                                                            
                                                         An extended color picker that enables picking a color using a spectrum, sliders, or text input.  | 
                                                    |
| 
                                                        
                                                            WindowSill.ImageHelper
                                                        
                                                         Drag and drop images for instant processing. Convert formats, resize, or compress without opening bulky editing software. Handle single images or batch-process dozens at once; all the essential image tools you need, right in your digital window sill.  | 
                                                    |
| 
                                                        
                                                            Eto.Platform.WinUI
                                                        
                                                         Package Description  | 
                                                    |
| 
                                                        
                                                            ShadowViewer.Plugin.Bika
                                                        
                                                         ShadowViewer哔咔漫画插件  | 
                                                    
GitHub repositories (31)
Showing the top 20 popular GitHub repositories that depend on CommunityToolkit.WinUI.Controls.Primitives:
| Repository | Stars | 
|---|---|
| 
                                                        
                                                            microsoft/PowerToys
                                                        
                                                         
                                                            Microsoft PowerToys is a collection of utilities that help you customize Windows and streamline everyday tasks
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            files-community/Files
                                                        
                                                         
                                                            A modern file manager that helps users organize their files and folders.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            marticliment/UniGetUI
                                                        
                                                         
                                                            UniGetUI: The Graphical Interface for your package managers. Could be terribly described as a package manager manager to manage your package managers
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            rocksdanister/lively
                                                        
                                                         
                                                            Free and open-source software that allows users to set animated desktop wallpapers and screensavers powered by WinUI 3.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            DGP-Studio/Snap.Hutao
                                                        
                                                         
                                                            实用的开源多功能原神工具箱 🧰 / Multifunctional Open-source Genshin Impact Toolkit 🧰
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            MicaForEveryone/MicaForEveryone
                                                        
                                                         
                                                            Mica For Everyone is a tool to enable backdrop effects on the title bars of Win32 apps on Windows 11.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            Sophia-Community/SophiApp
                                                        
                                                         
                                                            :zap: The most powerful open source tweaker on GitHub for fine-tuning Windows 10 & Windows 11
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            Scighost/Starward
                                                        
                                                         
                                                            Game Launcher for miHoYo  -  米家游戏启动器
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            picoe/Eto
                                                        
                                                         
                                                            Cross platform GUI framework for desktop and mobile applications in .NET
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            microsoft/WinUI-Gallery
                                                        
                                                         
                                                            This app demonstrates the controls available in WinUI and the Fluent Design System.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            Sergio0694/ComputeSharp
                                                        
                                                         
                                                            A .NET library to run C# code in parallel on the GPU through DX12, D2D1, and dynamically generated HLSL compute and pixel shaders, with the goal of making GPU computing easy to use for all .NET developers! 🚀
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            HotCakeX/Harden-Windows-Security
                                                        
                                                         
                                                            Harden Windows Safely, Securely using Official Supported Microsoft methods and proper explanation | Always up-to-date and works with the latest build of Windows | Provides tools and Guides for Personal, Enterprise, Government and Military security levels | SLSA Level 3 Compliant for Secure Development and Build Process | Apps Available on MS Store✨
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            Pixeval/Pixeval
                                                        
                                                         
                                                            Wow. Yet another Pixiv client!
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            rayenghanmi/RyTuneX
                                                        
                                                         
                                                            RyTuneX is a cutting-edge optimizer built with the WinUI 3 framework, designed to amplify the performance of Windows devices. Crafted for both Windows 10 and 11.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            ProtonVPN/win-app
                                                        
                                                         
                                                            Official ProtonVPN Windows app
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            CollapseLauncher/Collapse
                                                        
                                                         
                                                            An Advanced Launcher for miHoYo/HoYoverse Games
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            microsoft/ai-dev-gallery
                                                        
                                                         
                                                            An open-source project for Windows developers to learn how to add AI with local models and APIs to Windows apps.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            jayfunc/BetterLyrics
                                                        
                                                         
                                                            An elegant and deeply customizable lyrics & player app, built with WinUI3/Win2D | 一款优雅且高度自定义的歌词/播放器应用,基于 WinUI3/Win2D 构建
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            IviriusCommunity/Rebound
                                                        
                                                         
                                                            WinUI rewrite project of Windows 11 system apps.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            2fast-team/2fast
                                                        
                                                         
                                                            Two-Factor Authenticator Supporting TOTP (Windows 10 & Android, iOS, Linux and macOS App)
                                                         
                                                     | 
                                                    
| Version | Downloads | Last Updated | 
|---|---|---|
| 8.2.250402 | 61,541 | 4/2/2025 | 
| 8.2.250129-preview2 | 7,140 | 1/28/2025 | 
| 8.2.241112-preview1 | 3,771 | 11/14/2024 | 
| 8.1.240916 | 77,487 | 9/16/2024 | 
| 8.1.240821 | 9,521 | 8/22/2024 | 
| 8.1.240606-rc | 7,220 | 6/6/2024 | 
| 8.1.240328-rc | 8,620 | 3/28/2024 | 
| 8.0.240109 | 70,450 | 1/9/2024 | 
| 8.0.230907 | 15,696 | 9/7/2023 | 
| 8.0.230828-rc | 322 | 8/29/2023 | 
| 8.0.230823-rc | 630 | 8/23/2023 |