From 9dcf4c3352d2fb7353673a0ea12de6ee42f4689f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 24 Nov 2025 15:23:36 +0000
Subject: [PATCH 01/11] Initial plan


From a79d5986f4d343a3d8f5de38e75aa10f99d6c697 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 24 Nov 2025 15:41:01 +0000
Subject: [PATCH 02/11] Add comprehensive README for Microsoft.Maui.Controls
 NuGet package

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/Controls.NuGet.csproj |   5 +
 src/Controls/src/NuGet/README.md             | 282 +++++++++++++++++++
 2 files changed, 287 insertions(+)
 create mode 100644 src/Controls/src/NuGet/README.md

diff --git a/src/Controls/src/NuGet/Controls.NuGet.csproj b/src/Controls/src/NuGet/Controls.NuGet.csproj
index 41396d6d4af5..45ae01cd4aa0 100644
--- a/src/Controls/src/NuGet/Controls.NuGet.csproj
+++ b/src/Controls/src/NuGet/Controls.NuGet.csproj
@@ -20,6 +20,7 @@
 		<IsPackable>true</IsPackable>
 		<PackageId>Microsoft.Maui.Controls</PackageId>
 		<Description>.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, Tizen, and Windows from a single shared codebase.</Description>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
 	</PropertyGroup>
 
 	<ItemGroup>
@@ -29,6 +30,10 @@
 		<ProjectReference Include="..\..\..\SingleProject\Resizetizer\src\Resizetizer.csproj" />
 	</ItemGroup>
 
+	<ItemGroup>
+		<None Include="README.md" Pack="true" PackagePath="\" />
+	</ItemGroup>
+
 	<Import Project="$(MauiSrcDirectory)Workload\Shared\LibraryPacks.targets" />
 
 </Project>
diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
new file mode 100644
index 000000000000..d6f9f4efcb74
--- /dev/null
+++ b/src/Controls/src/NuGet/README.md
@@ -0,0 +1,282 @@
+# .NET Multi-platform App UI (.NET MAUI) Controls
+
+![Build Status](https://img.shields.io/azure-devops/build/xamarin/public/57/main?label=Build&style=flat-square) 
+![NuGet](https://img.shields.io/nuget/v/Microsoft.Maui.Controls?style=flat-square&label=NuGet)
+![License](https://img.shields.io/github/license/dotnet/maui?style=flat-square&label=License)
+
+[.NET Multi-platform App UI (.NET MAUI)](https://dotnet.microsoft.com/en-us/apps/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 Controls?
+
+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 24 (Android 7.0) |
+| iOS | iOS 13.0+ |
+| iPadOS | iPadOS 13.0+ |
+| macOS | macOS 11.0+ (via Mac Catalyst) |
+| Windows | Windows 11, Windows 10 (Version 1809+) |
+
+## 📦 Getting Started
+
+### Prerequisites
+
+- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) (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:
+
+```bash
+dotnet workload install maui
+```
+
+### Create a New Project
+
+Create a new .NET MAUI app using the CLI:
+
+```bash
+dotnet new maui -n MyMauiApp
+cd MyMauiApp
+```
+
+Or create with sample content including Community Toolkit and Syncfusion Toolkit:
+
+```bash
+dotnet new maui -n MyMauiApp -sc
+```
+
+### Run Your App
+
+Run on Android:
+```bash
+dotnet build -t:Run -f net10.0-android
+```
+
+Run on iOS (Mac only):
+```bash
+dotnet build -t:Run -f net10.0-ios
+```
+
+Run on Windows:
+```bash
+dotnet build -t:Run -f net10.0-windows
+```
+
+## 💡 Quick Start Example
+
+Here's a simple .NET MAUI page with various controls:
+
+### XAML (MainPage.xaml)
+
+```xml
+<?xml version="1.0" encoding="utf-8" ?>
+<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             x:Class="MyMauiApp.MainPage"
+             BackgroundColor="{DynamicResource PageBackgroundColor}">
+
+    <ScrollView>
+        <VerticalStackLayout Spacing="25" Padding="30">
+            
+            <Image Source="dotnet_bot.png" 
+                   HeightRequest="185"
+                   Aspect="AspectFit" />
+            
+            <Label Text="Hello, .NET MAUI!"
+                   Style="{StaticResource Headline}"
+                   HorizontalOptions="Center" />
+            
+            <Label Text="Build native apps for mobile and desktop"
+                   HorizontalOptions="Center" />
+            
+            <Entry Placeholder="Enter your name"
+                   x:Name="NameEntry" />
+            
+            <Button Text="Click Me"
+                    Clicked="OnCounterClicked"
+                    HorizontalOptions="Fill" />
+            
+            <Label x:Name="CounterLabel"
+                   Text="Button not clicked yet"
+                   HorizontalOptions="Center" />
+                   
+        </VerticalStackLayout>
+    </ScrollView>
+
+</ContentPage>
+```
+
+### Code-Behind (MainPage.xaml.cs)
+
+```csharp
+namespace MyMauiApp;
+
+public partial class MainPage : ContentPage
+{
+    private int count = 0;
+
+    public MainPage()
+    {
+        InitializeComponent();
+    }
+
+    private void OnCounterClicked(object sender, EventArgs e)
+    {
+        count++;
+        
+        if (count == 1)
+            CounterLabel.Text = $"Hello {NameEntry.Text}! Button clicked {count} time";
+        else
+            CounterLabel.Text = $"Hello {NameEntry.Text}! Button clicked {count} times";
+
+        SemanticScreenReader.Announce(CounterLabel.Text);
+    }
+}
+```
+
+## 🎯 Key Features
+
+### MVVM and Data Binding
+
+.NET MAUI fully supports the Model-View-ViewModel (MVVM) pattern with powerful data binding:
+
+```xml
+<Label Text="{Binding UserName}" />
+<Entry Text="{Binding Email, Mode=TwoWay}" />
+```
+
+Use the [.NET MAUI Community Toolkit](https://github.com/CommunityToolkit/Maui) for MVVM helpers and the [MVVM Toolkit](https://github.com/CommunityToolkit/dotnet) for source generators and commands.
+
+### Shell Navigation
+
+Shell provides a structured, performant navigation experience:
+
+```xml
+<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
+    <TabBar>
+        <ShellContent Title="Home" Icon="home.png" ContentTemplate="{DataTemplate local:HomePage}" />
+        <ShellContent Title="Profile" Icon="profile.png" ContentTemplate="{DataTemplate local:ProfilePage}" />
+    </TabBar>
+</Shell>
+```
+
+### Collections and Lists
+
+Display lists and collections with CollectionView:
+
+```xml
+<CollectionView ItemsSource="{Binding Items}">
+    <CollectionView.ItemTemplate>
+        <DataTemplate>
+            <Grid Padding="10">
+                <Label Text="{Binding Name}" FontSize="18" />
+            </Grid>
+        </DataTemplate>
+    </CollectionView.ItemTemplate>
+</CollectionView>
+```
+
+### Responsive Layouts
+
+Build adaptive UIs that work across different screen sizes:
+
+```xml
+<Grid RowDefinitions="Auto,*" ColumnDefinitions="*,*">
+    <Label Grid.Row="0" Grid.ColumnSpan="2" Text="Header" />
+    <BoxView Grid.Row="1" Grid.Column="0" Color="Red" />
+    <BoxView Grid.Row="1" Grid.Column="1" Color="Blue" />
+</Grid>
+```
+
+## 📚 Documentation and Resources
+
+### Official Documentation
+- [.NET MAUI Documentation](https://learn.microsoft.com/dotnet/maui/) - Complete guide to building apps
+- [API Reference](https://learn.microsoft.com/dotnet/api/?view=net-maui-10.0) - Detailed API documentation
+- [Controls Documentation](https://learn.microsoft.com/dotnet/maui/user-interface/controls/) - All available controls
+- [What's New in .NET 10](https://learn.microsoft.com/dotnet/maui/whats-new/dotnet-10) - Latest features and improvements
+
+### Learning Resources
+- [.NET MAUI Samples](https://github.com/dotnet/maui-samples) - Official sample applications
+- [.NET MAUI Workshop](https://github.com/dotnet-presentations/dotnet-maui-workshop) - Hands-on learning workshop
+- [Microsoft Learn](https://learn.microsoft.com/training/paths/build-apps-with-dotnet-maui/) - Free training modules
+- [.NET MAUI Blog](https://devblogs.microsoft.com/dotnet/category/net-maui/) - Latest news and updates
+
+### Community Resources
+- [.NET MAUI Community Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/maui/) - Additional controls, behaviors, and converters
+- [Awesome .NET MAUI](https://github.com/jsuarezruiz/awesome-dotnet-maui) - Curated list of resources
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/.net-maui) - Community Q&A
+
+## 💬 Feedback and Support
+
+We welcome your feedback and contributions!
+
+### Getting Help
+- **Documentation**: Check the [official documentation](https://learn.microsoft.com/dotnet/maui/)
+- **Q&A**: Ask questions on [Stack Overflow](https://stackoverflow.com/questions/tagged/.net-maui) with the `.net-maui` tag
+- **Discussions**: Join [GitHub Discussions](https://github.com/dotnet/maui/discussions) for community conversations
+
+### Reporting Issues
+- **Bug Reports**: File bugs at [GitHub Issues](https://github.com/dotnet/maui/issues)
+- **Feature Requests**: Suggest new features in [GitHub Issues](https://github.com/dotnet/maui/issues)
+- **Security Issues**: Report security vulnerabilities via [Microsoft Security Response Center](https://msrc.microsoft.com/)
+
+### Community
+- **Discord**: Join the [.NET Discord server](https://aka.ms/dotnet-discord)
+- **Twitter**: Follow [@dotnet](https://twitter.com/dotnet) and [@mauidotnet](https://twitter.com/mauidotnet)
+- **YouTube**: Watch tutorials on [dotnet YouTube channel](https://www.youtube.com/dotnet)
+
+## 🤝 Contributing
+
+We encourage contributions from the community! .NET MAUI is an open-source project.
+
+- **Contributing Guide**: Read our [Contributing Guidelines](https://github.com/dotnet/maui/blob/main/.github/CONTRIBUTING.md)
+- **Development Guide**: See the [Development Guide](https://github.com/dotnet/maui/blob/main/.github/DEVELOPMENT.md) for building locally
+- **Code of Conduct**: Review our [Code of Conduct](https://github.com/dotnet/maui/blob/main/.github/CODE_OF_CONDUCT.md)
+- **Good First Issues**: Find [good first issues](https://github.com/dotnet/maui/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) to start contributing
+
+## 🔧 Related Packages
+
+.NET MAUI consists of several packages that work together:
+
+| Package | Description |
+|---------|-------------|
+| [Microsoft.Maui.Controls](https://www.nuget.org/packages/Microsoft.Maui.Controls) | Core UI controls and XAML (this package) |
+| [Microsoft.Maui.Core](https://www.nuget.org/packages/Microsoft.Maui.Core) | Platform abstractions and handlers |
+| [Microsoft.Maui.Essentials](https://www.nuget.org/packages/Microsoft.Maui.Essentials) | Cross-platform APIs (merged into Core) |
+| [Microsoft.Maui.Graphics](https://www.nuget.org/packages/Microsoft.Maui.Graphics) | Cross-platform graphics library |
+| [CommunityToolkit.Maui](https://www.nuget.org/packages/CommunityToolkit.Maui) | Community-built controls and helpers |
+
+## 📄 License
+
+.NET MAUI is licensed under the [MIT License](https://github.com/dotnet/maui/blob/main/LICENSE.TXT).
+
+## 🎉 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](https://dotnet.microsoft.com/en-us/apps/maui)** | 
+**[Documentation](https://learn.microsoft.com/dotnet/maui/)** | 
+**[Samples](https://github.com/dotnet/maui-samples)** | 
+**[GitHub](https://github.com/dotnet/maui)**

From 9a2ebae624765fc00e859f4006d90bff0d80fd90 Mon Sep 17 00:00:00 2001
From: Gerald Versluis <gerald.versluis@microsoft.com>
Date: Mon, 24 Nov 2025 17:07:03 +0100
Subject: [PATCH 03/11] Update src/Controls/src/NuGet/README.md

---
 src/Controls/src/NuGet/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index d6f9f4efcb74..dd1f56b78739 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -4,7 +4,7 @@
 ![NuGet](https://img.shields.io/nuget/v/Microsoft.Maui.Controls?style=flat-square&label=NuGet)
 ![License](https://img.shields.io/github/license/dotnet/maui?style=flat-square&label=License)
 
-[.NET Multi-platform App UI (.NET MAUI)](https://dotnet.microsoft.com/en-us/apps/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.
+[.NET Multi-platform App UI (.NET MAUI)](https://dotnet.microsoft.com/apps/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 Controls?
 

From 84eb50e5499a21b5557b2c4c3a0dee441eb59458 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 24 Nov 2025 16:19:44 +0000
Subject: [PATCH 04/11] Change title to use product name .NET MAUI instead of
 .NET MAUI Controls

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index dd1f56b78739..2f0a2e6b14c6 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -1,4 +1,4 @@
-# .NET Multi-platform App UI (.NET MAUI) Controls
+# .NET Multi-platform App UI (.NET MAUI)
 
 ![Build Status](https://img.shields.io/azure-devops/build/xamarin/public/57/main?label=Build&style=flat-square) 
 ![NuGet](https://img.shields.io/nuget/v/Microsoft.Maui.Controls?style=flat-square&label=NuGet)
@@ -6,7 +6,7 @@
 
 [.NET Multi-platform App UI (.NET MAUI)](https://dotnet.microsoft.com/apps/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 Controls?
+## ✨ 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:
 

From f7ef51e4ec5e8f3f3545ae3e715afd101ac09ab0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 24 Nov 2025 19:55:48 +0000
Subject: [PATCH 05/11] Address PR feedback: Update Background property, add
 XAML enhancements, update Discord/social links

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index 2f0a2e6b14c6..f21342979ba1 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -92,7 +92,7 @@ Here's a simple .NET MAUI page with various controls:
 <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
              x:Class="MyMauiApp.MainPage"
-             BackgroundColor="{DynamicResource PageBackgroundColor}">
+             Background="{DynamicResource PageBackgroundColor}">
 
     <ScrollView>
         <VerticalStackLayout Spacing="25" Padding="30">
@@ -166,6 +166,15 @@ public partial class MainPage : ContentPage
 
 Use the [.NET MAUI Community Toolkit](https://github.com/CommunityToolkit/Maui) for MVVM helpers and the [MVVM Toolkit](https://github.com/CommunityToolkit/dotnet) for source generators and commands.
 
+### XAML Enhancements
+
+.NET MAUI includes powerful XAML features for cleaner, more efficient code:
+
+- **XAML Source Generation** - Compile-time XAML parsing for better performance and smaller app sizes
+- **XAML Simplifications** - Reduced boilerplate with improved syntax and type inference
+
+Learn more about [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc?view=net-maui-10.0).
+
 ### Shell Navigation
 
 Shell provides a structured, performant navigation experience:
@@ -241,9 +250,9 @@ We welcome your feedback and contributions!
 - **Security Issues**: Report security vulnerabilities via [Microsoft Security Response Center](https://msrc.microsoft.com/)
 
 ### Community
-- **Discord**: Join the [.NET Discord server](https://aka.ms/dotnet-discord)
-- **Twitter**: Follow [@dotnet](https://twitter.com/dotnet) and [@mauidotnet](https://twitter.com/mauidotnet)
-- **YouTube**: Watch tutorials on [dotnet YouTube channel](https://www.youtube.com/dotnet)
+- **Discord**: Join the [.NET Discord server](https://aka.ms/dotnet-discord) or the [MAUIverse Discord](https://mauiverse.net/discord) (community-driven, not Microsoft official)
+- **X (formerly Twitter)**: Follow [@dotnet](https://twitter.com/dotnet)
+- **YouTube**: Watch tutorials on [.NET YouTube channel](https://www.youtube.com/dotnet)
 
 ## 🤝 Contributing
 
@@ -276,7 +285,7 @@ We encourage contributions from the community! .NET MAUI is an open-source proje
 
 ---
 
-**[Get Started with .NET MAUI](https://dotnet.microsoft.com/en-us/apps/maui)** | 
+**[Get Started with .NET MAUI](https://dotnet.microsoft.com/apps/maui)** | 
 **[Documentation](https://learn.microsoft.com/dotnet/maui/)** | 
 **[Samples](https://github.com/dotnet/maui-samples)** | 
 **[GitHub](https://github.com/dotnet/maui)**

From 7398c6a81f26428338ac7596920783abac9e4843 Mon Sep 17 00:00:00 2001
From: Gerald Versluis <gerald.versluis@microsoft.com>
Date: Sun, 30 Nov 2025 16:36:17 +0100
Subject: [PATCH 06/11] Update src/Controls/src/NuGet/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index f21342979ba1..34c0e00abcc3 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -78,7 +78,7 @@ dotnet build -t:Run -f net10.0-ios
 
 Run on Windows:
 ```bash
-dotnet build -t:Run -f net10.0-windows
+dotnet build -t:Run -f net10.0-windows10.0.19041.0
 ```
 
 ## 💡 Quick Start Example

From 3181b90f0370b36ef4555f90d531360420aa83f8 Mon Sep 17 00:00:00 2001
From: Gerald Versluis <gerald.versluis@microsoft.com>
Date: Fri, 5 Dec 2025 09:32:41 +0100
Subject: [PATCH 07/11] Update src/Controls/src/NuGet/README.md

Co-authored-by: Kartheek Penagamuri <kapenaga@microsoft.com>
---
 src/Controls/src/NuGet/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index 34c0e00abcc3..463853d536d9 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -173,7 +173,7 @@ Use the [.NET MAUI Community Toolkit](https://github.com/CommunityToolkit/Maui)
 - **XAML Source Generation** - Compile-time XAML parsing for better performance and smaller app sizes
 - **XAML Simplifications** - Reduced boilerplate with improved syntax and type inference
 
-Learn more about [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc?view=net-maui-10.0).
+Learn more about [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc).
 
 ### Shell Navigation
 

From e9f095a574b45511381b3d42b8a9e9bdeb7a9d59 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 5 Dec 2025 14:11:31 +0000
Subject: [PATCH 08/11] Add Mac Catalyst run command and replace code examples
 with doc links

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 136 +++++++------------------------
 1 file changed, 29 insertions(+), 107 deletions(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index 463853d536d9..7279f8881e8b 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -76,6 +76,11 @@ Run on iOS (Mac only):
 dotnet build -t:Run -f net10.0-ios
 ```
 
+Run on Mac Catalyst (Mac only):
+```bash
+dotnet build -t:Run -f net10.0-maccatalyst
+```
+
 Run on Windows:
 ```bash
 dotnet build -t:Run -f net10.0-windows10.0.19041.0
@@ -83,138 +88,55 @@ dotnet build -t:Run -f net10.0-windows10.0.19041.0
 
 ## 💡 Quick Start Example
 
-Here's a simple .NET MAUI page with various controls:
-
-### XAML (MainPage.xaml)
-
-```xml
-<?xml version="1.0" encoding="utf-8" ?>
-<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
-             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
-             x:Class="MyMauiApp.MainPage"
-             Background="{DynamicResource PageBackgroundColor}">
-
-    <ScrollView>
-        <VerticalStackLayout Spacing="25" Padding="30">
-            
-            <Image Source="dotnet_bot.png" 
-                   HeightRequest="185"
-                   Aspect="AspectFit" />
-            
-            <Label Text="Hello, .NET MAUI!"
-                   Style="{StaticResource Headline}"
-                   HorizontalOptions="Center" />
-            
-            <Label Text="Build native apps for mobile and desktop"
-                   HorizontalOptions="Center" />
-            
-            <Entry Placeholder="Enter your name"
-                   x:Name="NameEntry" />
-            
-            <Button Text="Click Me"
-                    Clicked="OnCounterClicked"
-                    HorizontalOptions="Fill" />
-            
-            <Label x:Name="CounterLabel"
-                   Text="Button not clicked yet"
-                   HorizontalOptions="Center" />
-                   
-        </VerticalStackLayout>
-    </ScrollView>
-
-</ContentPage>
-```
-
-### Code-Behind (MainPage.xaml.cs)
+To get started quickly with .NET MAUI, follow our comprehensive tutorials:
 
-```csharp
-namespace MyMauiApp;
-
-public partial class MainPage : ContentPage
-{
-    private int count = 0;
-
-    public MainPage()
-    {
-        InitializeComponent();
-    }
-
-    private void OnCounterClicked(object sender, EventArgs e)
-    {
-        count++;
-        
-        if (count == 1)
-            CounterLabel.Text = $"Hello {NameEntry.Text}! Button clicked {count} time";
-        else
-            CounterLabel.Text = $"Hello {NameEntry.Text}! Button clicked {count} times";
-
-        SemanticScreenReader.Announce(CounterLabel.Text);
-    }
-}
-```
+- [Build your first app](https://learn.microsoft.com/dotnet/maui/get-started/first-app) - Step-by-step guide with UI examples
+- [XAML basics](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/get-started) - Learn XAML fundamentals with visual examples
+- [Create a multi-page app](https://learn.microsoft.com/dotnet/maui/tutorials/notes-app/) - Build a complete note-taking app
 
 ## 🎯 Key Features
 
 ### MVVM and Data Binding
 
-.NET MAUI fully supports the Model-View-ViewModel (MVVM) pattern with powerful data binding:
-
-```xml
-<Label Text="{Binding UserName}" />
-<Entry Text="{Binding Email, Mode=TwoWay}" />
-```
+.NET MAUI fully supports the Model-View-ViewModel (MVVM) pattern with powerful data binding. Learn more:
 
-Use the [.NET MAUI Community Toolkit](https://github.com/CommunityToolkit/Maui) for MVVM helpers and the [MVVM Toolkit](https://github.com/CommunityToolkit/dotnet) for source generators and commands.
+- [Data binding fundamentals](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/data-binding-basics) - Visual examples of data binding
+- [MVVM pattern](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/mvvm) - Complete MVVM guide with examples
+- [.NET MAUI Community Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/maui/) - MVVM helpers and more
+- [MVVM Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/mvvm/) - Source generators and commands
 
 ### XAML Enhancements
 
 .NET MAUI includes powerful XAML features for cleaner, more efficient code:
 
-- **XAML Source Generation** - Compile-time XAML parsing for better performance and smaller app sizes
-- **XAML Simplifications** - Reduced boilerplate with improved syntax and type inference
-
-Learn more about [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc).
+- [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc) - Better performance and smaller app sizes
+- [XAML markup extensions](https://learn.microsoft.com/dotnet/maui/xaml/markup-extensions/consume) - Extend XAML capabilities
+- [XAML hot reload](https://learn.microsoft.com/dotnet/maui/xaml/hot-reload) - See changes instantly during development
 
 ### Shell Navigation
 
 Shell provides a structured, performant navigation experience:
 
-```xml
-<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
-    <TabBar>
-        <ShellContent Title="Home" Icon="home.png" ContentTemplate="{DataTemplate local:HomePage}" />
-        <ShellContent Title="Profile" Icon="profile.png" ContentTemplate="{DataTemplate local:ProfilePage}" />
-    </TabBar>
-</Shell>
-```
+- [Shell overview](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/) - Introduction to Shell navigation
+- [Shell navigation](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/navigation) - Routing and navigation patterns
+- [Shell tabs](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/tabs) - Create tabbed interfaces
 
 ### Collections and Lists
 
-Display lists and collections with CollectionView:
-
-```xml
-<CollectionView ItemsSource="{Binding Items}">
-    <CollectionView.ItemTemplate>
-        <DataTemplate>
-            <Grid Padding="10">
-                <Label Text="{Binding Name}" FontSize="18" />
-            </Grid>
-        </DataTemplate>
-    </CollectionView.ItemTemplate>
-</CollectionView>
-```
+Display lists and collections with powerful controls:
+
+- [CollectionView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/collectionview/) - High-performance lists with UI examples
+- [ListView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/listview) - Traditional list view control
+- [CarouselView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/carouselview/) - Scrollable carousel of items
 
 ### Responsive Layouts
 
 Build adaptive UIs that work across different screen sizes:
 
-```xml
-<Grid RowDefinitions="Auto,*" ColumnDefinitions="*,*">
-    <Label Grid.Row="0" Grid.ColumnSpan="2" Text="Header" />
-    <BoxView Grid.Row="1" Grid.Column="0" Color="Red" />
-    <BoxView Grid.Row="1" Grid.Column="1" Color="Blue" />
-</Grid>
-```
+- [Layouts](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/) - Overview of all layout types
+- [Grid layout](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/grid) - Flexible grid with visual examples
+- [FlexLayout](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/flexlayout) - CSS flexbox-style layout
+- [Adaptive layouts](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/choose-layout) - Design for different screen sizes
 
 ## 📚 Documentation and Resources
 

From 7fdae5b51fc7d302579ab2d73f776f4026c11486 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 5 Dec 2025 14:32:57 +0000
Subject: [PATCH 09/11] Add code snippets alongside doc links and remove
 ListView reference

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 113 +++++++++++++++++++++++++------
 1 file changed, 94 insertions(+), 19 deletions(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index 7279f8881e8b..a8916c98c61f 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -88,55 +88,130 @@ dotnet build -t:Run -f net10.0-windows10.0.19041.0
 
 ## 💡 Quick Start Example
 
-To get started quickly with .NET MAUI, follow our comprehensive tutorials:
+Here's a simple .NET MAUI page to get you started:
+
+```xml
+<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>
+```
 
-- [Build your first app](https://learn.microsoft.com/dotnet/maui/get-started/first-app) - Step-by-step guide with UI examples
-- [XAML basics](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/get-started) - Learn XAML fundamentals with visual examples
-- [Create a multi-page app](https://learn.microsoft.com/dotnet/maui/tutorials/notes-app/) - Build a complete note-taking app
+**Learn more:**
+- [Build your first app](https://learn.microsoft.com/dotnet/maui/get-started/first-app) - Complete tutorial with UI examples
+- [XAML basics](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/get-started) - Learn XAML fundamentals
+- [Create a multi-page app](https://learn.microsoft.com/dotnet/maui/tutorials/notes-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. Learn more:
+.NET MAUI fully supports the Model-View-ViewModel (MVVM) pattern with powerful data binding:
+
+```xml
+<Label Text="{Binding UserName}" />
+<Entry Text="{Binding Email, Mode=TwoWay}" />
+```
 
-- [Data binding fundamentals](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/data-binding-basics) - Visual examples of data binding
-- [MVVM pattern](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/mvvm) - Complete MVVM guide with examples
-- [.NET MAUI Community Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/maui/) - MVVM helpers and more
+**Learn more:**
+- [Data binding fundamentals](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/data-binding-basics) - Complete guide with examples
+- [MVVM pattern](https://learn.microsoft.com/dotnet/maui/xaml/fundamentals/mvvm) - Implementing MVVM
+- [.NET MAUI Community Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/maui/) - MVVM helpers
 - [MVVM Toolkit](https://learn.microsoft.com/dotnet/communitytoolkit/mvvm/) - Source generators and commands
 
 ### XAML Enhancements
 
 .NET MAUI includes powerful XAML features for cleaner, more efficient code:
 
-- [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc) - Better performance and smaller app sizes
-- [XAML markup extensions](https://learn.microsoft.com/dotnet/maui/xaml/markup-extensions/consume) - Extend XAML capabilities
-- [XAML hot reload](https://learn.microsoft.com/dotnet/maui/xaml/hot-reload) - See changes instantly during development
+```xml
+<!-- Simplified property syntax -->
+<Button Text="Click Me" Clicked="OnClicked" />
+
+<!-- Markup extensions -->
+<Label Text="{Binding Title}" 
+       TextColor="{StaticResource PrimaryColor}" />
+```
+
+**Learn more:**
+- [XAML compilation and source generation](https://learn.microsoft.com/dotnet/maui/xaml/xamlc) - Better performance
+- [XAML markup extensions](https://learn.microsoft.com/dotnet/maui/xaml/markup-extensions/consume) - Extend capabilities
+- [XAML hot reload](https://learn.microsoft.com/dotnet/maui/xaml/hot-reload) - Instant updates during development
 
 ### Shell Navigation
 
 Shell provides a structured, performant navigation experience:
 
-- [Shell overview](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/) - Introduction to Shell navigation
-- [Shell navigation](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/navigation) - Routing and navigation patterns
+```xml
+<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](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/) - Getting started with Shell
+- [Shell navigation](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/navigation) - Navigation patterns
 - [Shell tabs](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/tabs) - Create tabbed interfaces
 
 ### Collections and Lists
 
-Display lists and collections with powerful controls:
+Display lists and collections with CollectionView:
+
+```xml
+<CollectionView ItemsSource="{Binding Items}">
+    <CollectionView.ItemTemplate>
+        <DataTemplate>
+            <Grid Padding="10">
+                <Label Text="{Binding Name}" 
+                       FontSize="18" />
+            </Grid>
+        </DataTemplate>
+    </CollectionView.ItemTemplate>
+</CollectionView>
+```
 
-- [CollectionView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/collectionview/) - High-performance lists with UI examples
-- [ListView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/listview) - Traditional list view control
-- [CarouselView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/carouselview/) - Scrollable carousel of items
+**Learn more:**
+- [CollectionView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/collectionview/) - High-performance lists
+- [CarouselView](https://learn.microsoft.com/dotnet/maui/user-interface/controls/carouselview/) - Scrollable carousel
 
 ### Responsive Layouts
 
 Build adaptive UIs that work across different screen sizes:
 
+```xml
+<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](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/) - Overview of all layout types
-- [Grid layout](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/grid) - Flexible grid with visual examples
+- [Grid layout](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/grid) - Flexible grid system
 - [FlexLayout](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/flexlayout) - CSS flexbox-style layout
-- [Adaptive layouts](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/choose-layout) - Design for different screen sizes
+- [Adaptive layouts](https://learn.microsoft.com/dotnet/maui/user-interface/layouts/choose-layout) - Multi-screen design
 
 ## 📚 Documentation and Resources
 

From 0883dbfc463a68ef878559ed8f1a2b717cd064e8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 15:03:25 +0000
Subject: [PATCH 10/11] Remove build status badge from README

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
---
 src/Controls/src/NuGet/README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index a8916c98c61f..22ae5de8708a 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -1,6 +1,5 @@
 # .NET Multi-platform App UI (.NET MAUI)
 
-![Build Status](https://img.shields.io/azure-devops/build/xamarin/public/57/main?label=Build&style=flat-square) 
 ![NuGet](https://img.shields.io/nuget/v/Microsoft.Maui.Controls?style=flat-square&label=NuGet)
 ![License](https://img.shields.io/github/license/dotnet/maui?style=flat-square&label=License)
 

From 57e9c3afd817c6ff6441904918b7b6fa4e74aa4b Mon Sep 17 00:00:00 2001
From: Gerald Versluis <gerald.versluis@microsoft.com>
Date: Thu, 11 Dec 2025 16:22:10 +0100
Subject: [PATCH 11/11] Update src/Controls/src/NuGet/README.md

---
 src/Controls/src/NuGet/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Controls/src/NuGet/README.md b/src/Controls/src/NuGet/README.md
index 22ae5de8708a..ba0214344084 100644
--- a/src/Controls/src/NuGet/README.md
+++ b/src/Controls/src/NuGet/README.md
@@ -24,11 +24,11 @@ The **Microsoft.Maui.Controls** package provides the UI controls and XAML infras
 
 | Platform | Minimum Version |
 |----------|----------------|
-| Android | API 24 (Android 7.0) |
+| Android | API 21 (Android 5.0) |
 | iOS | iOS 13.0+ |
 | iPadOS | iPadOS 13.0+ |
-| macOS | macOS 11.0+ (via Mac Catalyst) |
-| Windows | Windows 11, Windows 10 (Version 1809+) |
+| macOS | macOS 12.0+ (via Mac Catalyst) |
+| Windows | Windows 11, Windows 10 (Version 1809+) using Windows UI Library (WinUI) |
 
 ## 📦 Getting Started