Microsoft.Maui.Controls
10.0.20
Prefix Reserved
dotnet add package Microsoft.Maui.Controls --version 10.0.20
NuGet\Install-Package Microsoft.Maui.Controls -Version 10.0.20
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Microsoft.Maui.Controls" Version="10.0.20" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Microsoft.Maui.Controls" Version="10.0.20" />
<PackageReference Include="Microsoft.Maui.Controls" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Microsoft.Maui.Controls --version 10.0.20
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Microsoft.Maui.Controls, 10.0.20"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Microsoft.Maui.Controls@10.0.20
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Microsoft.Maui.Controls&version=10.0.20
#tool nuget:?package=Microsoft.Maui.Controls&version=10.0.20
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
.NET Multi-platform App UI (.NET MAUI)
.NET Multi-platform App UI (.NET MAUI) is a cross-platform framework for creating native mobile and desktop apps with C# and XAML. Using .NET MAUI, you can develop apps that run on Android, iOS, iPadOS, macOS, and Windows from a single shared codebase.
✨ What is .NET MAUI?
The Microsoft.Maui.Controls package provides the UI controls and XAML infrastructure for building beautiful, native cross-platform applications. It includes:
- 40+ UI controls - Buttons, labels, entries, pickers, lists, grids, and more
- XAML support - Design your UI with declarative markup
- Layout system - Flexible layouts including Grid, StackLayout, FlexLayout, and AbsoluteLayout
- Navigation - Shell navigation, NavigationPage, TabbedPage, FlyoutPage
- Data binding - Two-way data binding with MVVM support
- Styling and theming - Application-wide styles, dynamic resources, and light/dark theme support
- Platform integration - Access platform-specific features seamlessly
- Hot Reload - See UI changes instantly during development
🚀 Supported Platforms
.NET MAUI applications run on the following platforms:
| Platform | Minimum Version |
|---|---|
| Android | API 21 (Android 5.0) |
| iOS | iOS 13.0+ |
| iPadOS | iPadOS 13.0+ |
| macOS | macOS 12.0+ (via Mac Catalyst) |
| Windows | Windows 11, Windows 10 (Version 1809+) using Windows UI Library (WinUI) |
📦 Getting Started
Prerequisites
- .NET 10 SDK (or .NET 9 for previous versions)
- Platform-specific tools:
- Android: Android SDK (installed via Visual Studio or Android Studio)
- iOS/macOS: Xcode (Mac required)
- Windows: Windows App SDK
Installation
Install the .NET MAUI workload:
dotnet workload install maui
Create a New Project
Create a new .NET MAUI app using the CLI:
dotnet new maui -n MyMauiApp
cd MyMauiApp
Or create with sample content including Community Toolkit and Syncfusion Toolkit:
dotnet new maui -n MyMauiApp -sc
Run Your App
Run on Android:
dotnet build -t:Run -f net10.0-android
Run on iOS (Mac only):
dotnet build -t:Run -f net10.0-ios
Run on Mac Catalyst (Mac only):
dotnet build -t:Run -f net10.0-maccatalyst
Run on Windows:
dotnet build -t:Run -f net10.0-windows10.0.19041.0
💡 Quick Start Example
Here's a simple .NET MAUI page to get you started:
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">
<VerticalStackLayout Padding="30" Spacing="25">
<Label Text="Hello, .NET MAUI!"
FontSize="32"
HorizontalOptions="Center" />
<Button Text="Click Me"
Clicked="OnButtonClicked" />
<Label x:Name="CounterLabel"
Text="Button not clicked yet"
HorizontalOptions="Center" />
</VerticalStackLayout>
</ContentPage>
Learn more:
- Build your first app - Complete tutorial with UI examples
- XAML basics - Learn XAML fundamentals
- Create a multi-page app - Build a note-taking app
🎯 Key Features
MVVM and Data Binding
.NET MAUI fully supports the Model-View-ViewModel (MVVM) pattern with powerful data binding:
<Label Text="{Binding UserName}" />
<Entry Text="{Binding Email, Mode=TwoWay}" />
Learn more:
- Data binding fundamentals - Complete guide with examples
- MVVM pattern - Implementing MVVM
- .NET MAUI Community Toolkit - MVVM helpers
- MVVM Toolkit - Source generators and commands
XAML Enhancements
.NET MAUI includes powerful XAML features for cleaner, more efficient code:
<Button Text="Click Me" Clicked="OnClicked" />
<Label Text="{Binding Title}"
TextColor="{StaticResource PrimaryColor}" />
Learn more:
- XAML compilation and source generation - Better performance
- XAML markup extensions - Extend capabilities
- XAML hot reload - Instant updates during development
Shell Navigation
Shell provides a structured, performant navigation experience:
<Shell>
<TabBar>
<ShellContent Title="Home"
Icon="home.png"
ContentTemplate="{DataTemplate local:HomePage}" />
<ShellContent Title="Settings"
Icon="settings.png"
ContentTemplate="{DataTemplate local:SettingsPage}" />
</TabBar>
</Shell>
Learn more:
- Shell overview - Getting started with Shell
- Shell navigation - Navigation patterns
- Shell tabs - Create tabbed interfaces
Collections and Lists
Display lists and collections with CollectionView:
<CollectionView ItemsSource="{Binding Items}">
<CollectionView.ItemTemplate>
<DataTemplate>
<Grid Padding="10">
<Label Text="{Binding Name}"
FontSize="18" />
</Grid>
</DataTemplate>
</CollectionView.ItemTemplate>
</CollectionView>
Learn more:
- CollectionView - High-performance lists
- CarouselView - Scrollable carousel
Responsive Layouts
Build adaptive UIs that work across different screen sizes:
<Grid RowDefinitions="Auto,*"
ColumnDefinitions="*,*">
<Label Grid.ColumnSpan="2"
Text="Header" />
<BoxView Grid.Row="1"
Grid.Column="0"
Color="Blue" />
<BoxView Grid.Row="1"
Grid.Column="1"
Color="Green" />
</Grid>
Learn more:
- Layouts - Overview of all layout types
- Grid layout - Flexible grid system
- FlexLayout - CSS flexbox-style layout
- Adaptive layouts - Multi-screen design
📚 Documentation and Resources
Official Documentation
- .NET MAUI Documentation - Complete guide to building apps
- API Reference - Detailed API documentation
- Controls Documentation - All available controls
- What's New in .NET 10 - Latest features and improvements
Learning Resources
- .NET MAUI Samples - Official sample applications
- .NET MAUI Workshop - Hands-on learning workshop
- Microsoft Learn - Free training modules
- .NET MAUI Blog - Latest news and updates
Community Resources
- .NET MAUI Community Toolkit - Additional controls, behaviors, and converters
- Awesome .NET MAUI - Curated list of resources
- Stack Overflow - Community Q&A
💬 Feedback and Support
We welcome your feedback and contributions!
Getting Help
- Documentation: Check the official documentation
- Q&A: Ask questions on Stack Overflow with the
.net-mauitag - Discussions: Join GitHub Discussions for community conversations
Reporting Issues
- Bug Reports: File bugs at GitHub Issues
- Feature Requests: Suggest new features in GitHub Issues
- Security Issues: Report security vulnerabilities via Microsoft Security Response Center
Community
- Discord: Join the .NET Discord server or the MAUIverse Discord (community-driven, not Microsoft official)
- X (formerly Twitter): Follow @dotnet
- YouTube: Watch tutorials on .NET YouTube channel
🤝 Contributing
We encourage contributions from the community! .NET MAUI is an open-source project.
- Contributing Guide: Read our Contributing Guidelines
- Development Guide: See the Development Guide for building locally
- Code of Conduct: Review our Code of Conduct
- Good First Issues: Find good first issues to start contributing
🔧 Related Packages
.NET MAUI consists of several packages that work together:
| Package | Description |
|---|---|
| Microsoft.Maui.Controls | Core UI controls and XAML (this package) |
| Microsoft.Maui.Core | Platform abstractions and handlers |
| Microsoft.Maui.Essentials | Cross-platform APIs (merged into Core) |
| Microsoft.Maui.Graphics | Cross-platform graphics library |
| CommunityToolkit.Maui | Community-built controls and helpers |
📄 License
.NET MAUI is licensed under the MIT License.
🎉 Acknowledgements
.NET MAUI is the evolution of Xamarin.Forms, building on years of mobile and cross-platform development experience. We thank the community for their continued support and contributions.
Get Started with .NET MAUI | Documentation | Samples | GitHub
There are no supported framework assets in this package.
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
.NETStandard 2.1
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0-android36.0
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0-ios26.0
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0-maccatalyst26.0
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0-windows10.0.19041
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
-
net10.0-windows10.0.20348
- Microsoft.Maui.Controls.Build.Tasks (>= 10.0.20)
- Microsoft.Maui.Controls.Core (>= 10.0.20)
- Microsoft.Maui.Controls.Xaml (>= 10.0.20)
- Microsoft.Maui.Resizetizer (>= 10.0.20)
NuGet packages (874)
Showing the top 5 NuGet packages that depend on Microsoft.Maui.Controls:
| Package | Downloads |
|---|---|
|
CommunityToolkit.Maui
The .NET MAUI Community Toolkit is a collection of Animations, Behaviors, Converters, and Custom Views for development with .NET MAUI. It simplifies and demonstrates common developer tasks building iOS, Android, macOS and Windows apps with .NET MAUI. |
|
|
TIKSN-Framework
This is a .NET Framework enhancement framework. Main features are Versioning, Finance, Currency, Foreign Exchange, Money, Pricing strategy, Telemetry, Composite Weighted Progress, Repository and Unity of Wok pattern implementation with Entity Framework Core, Network Connectivity Service and Triggering, Settings, Windows Registry configuration source, Azure Storage Repository, MongoDB Repository, NoDB Repository, Lingual and Regional Localization, Serialization, Rest Requester, Rest Repository, Dependency Injection, Composition Root Setup base classes. |
|
|
SkiaSharp.Views.Maui.Controls
SkiaSharp for .NET MAUI is a set of views that can be used to draw on the screen. |
|
|
ZXing.Net.Maui
Package Description |
|
|
ZXing.Net.Maui.Controls
Package Description |
GitHub repositories (195)
Showing the top 20 popular GitHub repositories that depend on Microsoft.Maui.Controls:
| Repository | Stars |
|---|---|
|
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
|
|
|
dotnet/eShop
A reference .NET application implementing an eCommerce site
|
|
|
reactiveui/ReactiveUI
An advanced, composable, functional reactive model-view-viewmodel framework for all .NET platforms that is inspired by functional reactive programming. ReactiveUI allows you to abstract mutable state away from your user interfaces, express the idea around a feature in one readable place and improve the testability of your application.
|
|
|
PrismLibrary/Prism
Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Xamarin Forms, and Uno / Win UI Applications..
|
|
|
ScottPlot/ScottPlot
Interactive plotting library for .NET
|
|
|
mono/SkiaSharp
SkiaSharp is a cross-platform 2D graphics API for .NET platforms based on Google's Skia Graphics Library. It provides a comprehensive 2D API that can be used across mobile, server and desktop models to render images.
|
|
|
Live-Charts/LiveCharts2
Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere Maui, Uno Platform, Blazor-wasm, WPF, WinForms, Xamarin, Avalonia, WinUI, UWP.
|
|
|
openiddict/openiddict-core
Flexible and versatile OAuth 2.0/OpenID Connect stack for .NET
|
|
|
microsoft/fluentui-blazor
Microsoft Fluent UI Blazor components library. For use with ASP.NET Core Blazor applications
|
|
|
dotnet/maui-samples
Samples for .NET Multi-Platform App UI (.NET MAUI)
|
|
|
Cysharp/R3
The new future of dotnet/reactive and UniRx.
|
|
|
SciSharp/LLamaSharp
A C#/.NET library to run LLM (🦙LLaMA/LLaVA) on your local device efficiently.
|
|
|
Azure-Samples/cognitive-services-speech-sdk
Sample code for the Microsoft Cognitive Services Speech SDK
|
|
|
dotnet/sdk
Core functionality needed to create .NET Core projects, that is shared between Visual Studio and CLI
|
|
|
Caliburn-Micro/Caliburn.Micro
A small, yet powerful framework, designed for building applications across all XAML platforms. Its strong support for MV* patterns will enable you to build your solution quickly, without the need to sacrifice code quality or testability.
|
|
|
dotnet/macios
.NET for iOS, Mac Catalyst, macOS, and tvOS provide open-source bindings of the Apple SDKs for use with .NET managed languages such as C#
|
|
|
CommunityToolkit/Maui
The .NET MAUI Community Toolkit is a community-created library that contains .NET MAUI Extensions, Advanced UI/UX Controls, and Behaviors to help make your life as a .NET MAUI developer easier
|
|
|
reactiveui/Akavache
An asynchronous, persistent key-value store created for writing desktop and mobile applications, based on SQLite3. Akavache is great for both storing important data as well as cached local data that expires.
|
|
|
emgucv/emgucv
Emgu CV is a cross platform .Net wrapper to the OpenCV image processing library.
|
|
|
oqtane/oqtane.framework
Oqtane is an open-source developer productivity platform for building modern .NET applications and websites that run on Web, Desktop and Mobile.
|
| Version | Downloads | Last Updated |
|---|---|---|
| 10.0.20 | 25,907 | 12/16/2025 |
| 10.0.11 | 62,217 | 11/24/2025 |
| 10.0.10 | 66,629 | 11/11/2025 |
| 10.0.1 | 64,923 | 12/9/2025 |
| 10.0.0 | 95,471 | 11/11/2025 |
| 10.0.0-rc.2.25504.7 | 26,708 | 10/14/2025 |
| 10.0.0-rc.1.25452.6 | 20,840 | 9/9/2025 |
| 10.0.0-preview.7.25406.3 | 6,866 | 8/12/2025 |
| 10.0.0-preview.6.25359.8 | 7,074 | 7/15/2025 |
| 10.0.0-preview.5.25306.5 | 3,208 | 6/10/2025 |
| 10.0.0-preview.4.25263.4 | 4,187 | 5/13/2025 |
| 10.0.0-preview.4.25259.2 | 483 | 5/13/2025 |
| 10.0.0-preview.3.25208.1 | 4,617 | 4/10/2025 |
| 10.0.0-preview.2.25165.1 | 2,079 | 3/18/2025 |
| 10.0.0-preview.1.25122.6 | 2,695 | 2/25/2025 |
| 9.0.120 | 225,136 | 10/16/2025 |
| 9.0.111 | 294,514 | 10/14/2025 |
| 9.0.110 | 196,610 | 9/10/2025 |
| 9.0.100 | 159,206 | 8/13/2025 |
| 9.0.90 | 270,933 | 7/14/2025 |
| 9.0.82 | 540,018 | 7/10/2025 |
| 9.0.81 | 73,168 | 6/30/2025 |
| 9.0.80 | 182,185 | 6/12/2025 |
| 9.0.71 | 16,816 | 6/10/2025 |
| 9.0.70 | 220,400 | 5/13/2025 |
| 9.0.61 | 6,849 | 5/13/2025 |
| 9.0.60 | 229,117 | 4/10/2025 |
| 9.0.51 | 484,399 | 4/21/2025 |
| 9.0.50 | 353,399 | 3/13/2025 |
| 9.0.40 | 292,703 | 2/11/2025 |
| 9.0.30 | 389,220 | 1/14/2025 |
| 9.0.22 | 55,575 | 1/7/2025 |
| 9.0.21 | 186,660 | 12/12/2024 |
| 9.0.14 | 680,972 | 12/11/2024 |
| 9.0.12 | 36,615 | 12/3/2024 |
| 9.0.10 | 211,563 | 11/14/2024 |
| 9.0.0 | 389,669 | 11/12/2024 |
| 9.0.0-rc.2.24503.2 | 41,360 | 10/8/2024 |
| 9.0.0-rc.1.24453.9 | 21,023 | 9/10/2024 |
| 9.0.0-preview.7.24407.4 | 6,507 | 8/13/2024 |
| 9.0.0-preview.6.24327.7 | 19,840 | 7/9/2024 |
| 9.0.0-preview.5.24307.10 | 9,771 | 6/11/2024 |
| 9.0.0-preview.4.10690 | 11,360 | 5/21/2024 |
| 9.0.0-preview.3.10457 | 25,244 | 4/11/2024 |
| 9.0.0-preview.2.10293 | 3,208 | 3/12/2024 |
| 9.0.0-preview.1.9973 | 7,604 | 2/13/2024 |
| 8.0.100 | 1,626,088 | 11/14/2024 |
| 8.0.93 | 78,145 | 11/7/2024 |
| 8.0.92 | 340,453 | 10/15/2024 |
| 8.0.91 | 227,487 | 9/25/2024 |
| 8.0.90 | 125,893 | 9/13/2024 |
| 8.0.83 | 507,011 | 11/4/2024 |
| 8.0.82 | 1,117,693 | 8/28/2024 |
| 8.0.80 | 241,880 | 8/7/2024 |
| 8.0.72 | 295,152 | 8/12/2024 |
| 8.0.71 | 432,413 | 7/31/2024 |
| 8.0.70 | 221,385 | 7/9/2024 |
| 8.0.61 | 238,435 | 6/25/2024 |
| 8.0.60 | 123,411 | 6/12/2024 |
| 8.0.40 | 395,594 | 5/14/2024 |
| 8.0.21 | 496,144 | 4/23/2024 |
| 8.0.20 | 221,447 | 4/9/2024 |
| 8.0.14 | 340,461 | 3/21/2024 |
| 8.0.10 | 79,833 | 3/12/2024 |
| 8.0.7 | 553,123 | 2/14/2024 |
| 8.0.6 | 382,842 | 1/17/2024 |
| 8.0.3 | 905,096 | 11/14/2023 |
| 8.0.0-rc.2.9530 | 11,396 | 11/7/2023 |
| 8.0.0-rc.2.9511 | 7,413 | 10/31/2023 |
| 8.0.0-rc.2.9373 | 28,339 | 10/10/2023 |
| 8.0.0-rc.1.9171 | 38,472 | 9/12/2023 |
| 8.0.0-preview.7.8842 | 14,587 | 8/8/2023 |
| 8.0.0-preview.6.8686 | 13,070 | 7/11/2023 |
| 8.0.0-preview.5.8529 | 4,404 | 6/13/2023 |
| 8.0.0-preview.4.8333 | 2,707 | 5/16/2023 |
| 8.0.0-preview.3.8149 | 3,441 | 4/11/2023 |
| 8.0.0-preview.2.7871 | 3,166 | 3/14/2023 |
| 8.0.0-preview.1.7762 | 2,921 | 2/21/2023 |