Skip to main content
net11.0net11.0-android37.0net11.0-ios27.0net11.0-maccatalyst27.0net11.0-windows10.0.19041net11.0-windows10.0.20348

.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 can run on Android, iOS, macOS, and Windows from a single shared codebase.

Published
Nov 11, 2026
10d ago
Total Downloads
30.4M
30,434,034

Install

dotnet add package Microsoft.Maui.Controls --version 11.0.10
ProductVersions
.NET
net11.0net11.0-android37.0net11.0-ios27.0net11.0-maccatalyst27.0net11.0-windows10.0.19041net11.0-windows10.0.20348
.NET Standard
netstandard2.0netstandard2.1

README

.NET Multi-platform App UI (.NET MAUI)

NuGet License

.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

Agent upgrade guidance

This package includes the text-only skills/microsoft-maui-controls-upgrade-to-11/SKILL.md Agent Skill and supporting references. Ask a compatible agent to inspect the skill from your exact restored package when upgrading a Controls application to MAUI 11. The guidance covers version alignment, native customization and behavior-preserving checks.

NuGet restore does not execute or install the skill. Repository installation and refresh are separate operations; preserve local edits before refreshing. See NuGet package skills for discovery tooling and release-placement details.

πŸ’‘ 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:

🎯 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:

XAML Enhancements

.NET MAUI includes powerful XAML features for cleaner, more efficient code:

<!-- Simplified property syntax -->
<Button Text="Click Me" Clicked="OnClicked" />

<!-- Markup extensions -->
<Label Text="{Binding Title}" 
       TextColor="{StaticResource PrimaryColor}" />

Learn more:

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:

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:

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:

πŸ“š Documentation and Resources

Official Documentation

Learning Resources

Community Resources

πŸ’¬ Feedback and Support

We welcome your feedback and contributions!

Getting Help

Reporting Issues

Community

🀝 Contributing

We encourage contributions from the community! .NET MAUI is an open-source project.

πŸ”§ 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

Changes from Previous Version

No structural changes between v11.0.0 and v11.0.10.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

Compatibility metadata lists 8 target frameworks; confirm the exact target used by your application.The published metadata declares 32 direct dependency entries across framework groups. Inspect the resolved dependency graph for your target framework.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.