dotnetdotnet/maui/AGENTS.md

maui

AGENTS.md23k starsChanged 13 days agoMITView on GitHub

Choose the intended pull request base before starting a new change: For a .NET 11 fix, start from net11, not next-major main. After approval, a maintainer manually retargets the PR to the active versioned inflight branch, validates CI on that final base, and merges there. Agents must not retarget or merge PRs. Individual fixes are not merged directly into net11; candidate integration is separate release work. Read .github/CONTRIBUTING.md and resolve current roles from eng/release-rollover.json. Follow docs/ReleaseBranchWorkflow.md; do not hard-code an…

Jun 24, 2022Get Android CurrentActivity in .Net MAUI50 votes
Jan 10, 2024Maui project for Android: type androidx.collection.ArrayMapKt is defined multiple times22 votes
Nov 13, 2020.NET Core vs Mono21 votes
Feb 21, 2023.NET MAUI, ios UseSafeArea not working StackLayout, VerticalStackLayout and Grid17 votes
Jan 21, 2024Xamarin is end-of-life; what is its replacement for developing an Android app in C# Net?15 votes

25 more on Stack Overflow

Apr 2, 2022create normal windows desktop application using .net maui?15 votes · 3 answers
Sep 13, 2023NETSDK1083: The specified RuntimeIdentifier "win10-x64" is not recognized10 votes
Sep 13, 2022.Net MAUI how to include a link in a Label10 votes
Dec 11, 2023.NET MAUI app: The type 'maui:MauiWinUIApplication' was not found. Unable to build the .NET MAUI app9 votes
Oct 29, 2022MAUI .NET Set Window Size9 votes
Sep 12, 2022.Net MAUI how to include a link in a Label9 votes · 6 answers
Nov 17, 2023Maui ImageButton with FontImageSource - how to adjust image size? .net 88 votes · 3 answers
Nov 26, 2022.Net Maui: StorageWrite permission stops working with .net 7 on Android emulator8 votes
Nov 4, 2022Horizontal Scroll is not working in MAUI. What am I missing or is this a bug?8 votes
Aug 5, 2023MAUI CollectionView SelectedItem not updating7 votes
Dec 7, 2022MAUI iOS does not fit the screen7 votes
Sep 16, 2022"error CS0579: Duplicate 'global::Android.Runtime.Resource DesignerAttribute' attribute" while converting Xamarin project to .net MAUI7 votes · 1 answer
Aug 21, 2022CollectionView SelectionChanged method not triggering when tapping the item directly .NET MAUI7 votes
Dec 12, 2023The type or namespace name 'MauiWinUIApplication' does not exist in the namespace 'Microsoft.Maui'6 votes
May 31, 2023Why am I unable to trigger the click event or command on tapping bottom items in .Net Maui List View / Bindable Stack Layout?6 votes
Jun 28, 2022How to interact BlazorWebView and Windows Forms6 votes
May 27, 2022Errors with dotnet publish6 votes · 3 answers
Feb 8, 2024How Do You Create A Global Error Handling for a MAUI App5 votes
Sep 27, 2023How to do page handler with MAUI5 votes
Sep 6, 2023Is there a known bug when changing splash screen in .Net Maui?5 votes · 1 answer
Jul 12, 2023Layout options with AndExpand are deprecated from .Net Maui for only StackLayout or all controls?5 votes · 2 answers
Jan 11, 2023During scrolling ListView error "Cannot access a disposed object"5 votes
Oct 28, 2022Android WebViewClient's ShouldInterceptRequest is never called in MAUI WebView5 votes
Oct 18, 2022Unable to change the StatusBar when at the splashscreen for light and dark themes5 votes
Jun 28, 2022GIF image is not working in .net MAUI application5 votes · 5 answers

On YouTube · 20

Mar 11, 2021Learn Xamarin Today or Wait for .NET MAUI? — James Montemagno60k views · 194 comments
Oct 17, 2023Is There Hope For .NET MAUI? — SingletonSean37k views · 239 comments
Sep 29, 2022Check and Request Permissions in .NET MAUI — James Montemagno29k views · 67 comments
May 27, 2021.NET MAUI Preview 4: Time For You To Get Started? — Gerald Versluis24k views · 151 comments
Jul 20, 2021.NET MAUI Preview 6 - What You Need To Know — James Montemagno22k views · 62 comments

15 more on YouTube

Apr 6, 2021A Journey to .NET MAUI — dotnet16k views · 45 comments
Jun 25, 2021.NET MAUI Preview 5 - Animations, Shell, Brushes, & More! — James Montemagno15k views · 45 comments
May 27, 2022.NET MAUI - Updates and Roadmap | OD106 — Microsoft Developer15k views · 1 comment
Apr 21, 2022.NET MAUI Release Candidates! Multi-platform iOS, Android, macOS, & Windows in C# — James Montemagno15k views · 134 comments
Jan 31, 2023Translate Your .NET MAUI App with LocalizationResourceManager.Maui — Gerald Versluis10k views · 53 comments
Jan 20, 2024Upgrade .NET MAUI to 8.0.6 SR1 NOW in SECONDS! #dotnetmaui #dotnet — James Montemagno8.4k views · 8 comments
Mar 13, 2026AI-First Mobile Development: Live Coding with Copilot and .NET MAUI — dotnet7.5k views · 14 comments
Sep 23, 2021.NET MAUI Preview 8 - Tips & Tricks | Windows Setup, MVVM Hot Reload, and Dependency Injection — James Montemagno6.6k views · 43 comments
Jan 12, 2023Resources for Getting Started with .NET MAUI - .NET MAUI 101 — Gerald Versluis4.8k views · 35 comments
Apr 1, 2021.NET MAUI: Is Your Dev Machine Ready? 💉 — Gerald Versluis4.2k views · 38 comments
May 23, 2024Test Bugfixes on Your Own .NET MAUI Project Before They're Released!1! — Gerald Versluis2.8k views · 18 comments
Jun 12, 2022Exploring MAUI - Multiplatform Apps Built With .NET — World of Zero1.2k views · 1 comment
Aug 10, 2022Twitter Flyout using .NET MAUI Shell — Siddharth Singh408 views · 4 comments
Aug 15, 2024GitHub - dotnet/maui: .NET MAUI is the .NET Multi-platform App UI, a framework for building nativ... — GitHub Daily Trend AI Podcast52 views
Nov 27, 2022dotnet/maui - Gource visualisation — Gourcer44 views

On GitHub · 17

May 19, 2020[Enhancement] Multi-platform App UI (MAUI) Support — PrismLibrary/Prism127 reactions · 16 comments
Nov 12, 2021[API Proposal]: Add weak event listener helper class — dotnet/runtime54 reactions · 19 comments
Aug 22, 2022gtk ongoing — MauiGtk/maui-linux51 reactions · 17 comments
Sep 16, 2022JavaScript drag/drop events not working in WinUI specifically (WPF is fine) — MicrosoftEdge/WebView2Feedback41 reactions · 33 comments
Apr 15, 2024MAUI .NET 8.0 built with Full AOT Compilation reports a lot of `Mono : AOT NOT FOUND` — dotnet/runtime29 reactions · 137 comments

12 more on GitHub

Jan 20, 2023Enable support for NativeAOT targeting iOS via opt-in feature — dotnet/runtime29 reactions · 18 comments
Mar 21, 2024Upgrade to Maui Version 8.0.10 — MauiGtk/maui-linux11 reactions · 10 comments
Sep 18, 2021Update MBB to use MAUI — dotnet/MobileBlazorBindings10 reactions · 26 comments
Aug 29, 2023Gtk.BlazorWebView: Support Blazor Hybrid on Linux / over Gtk — MauiGtk/maui-linux7 reactions · 8 comments
Feb 24, 2023Port CollectionView performance fixes from .NET MAUI — xamarin/Xamarin.Forms6 reactions · 2 comments
Jun 18, 2025[src/runtime] Don't allow native code to resolve a weak reference for an object in the finalizer queue. — dotnet/macios5 reactions · 30 comments
Aug 3, 2023[workloads] Use native arm64 aot compilers for iOS, tvOS, maccatalyst, and android where possible — dotnet/runtime4 reactions · 2 comments
Jul 13, 2021merge dotnet/main main_linux & enhance 210713 — MauiGtk/maui-linux3 reactions · 1 comment
Jun 2, 2026fix: [.NET 10] PageNavigationExtensions updated for public Page properties — getsentry/sentry-dotnet2 reactions · 1 comment
Oct 27, 2025ci: fix/set `MtouchUseLlvm=false` to speed up the macOS build — getsentry/sentry-dotnet2 reactions · 1 comment
Oct 10, 2025Add Aspire.Hosting.Maui (.NET MAUI) integration — microsoft/aspire2 reactions · 3 comments
Aug 5, 2025[release/9.0.1xx] [build] update `$(ProductVersion)` to align with Android 15 — dotnet/android2 reactions · 1 comment

On Hacker News · 13

Apr 20, 2021.NET MAUI: .NET Multi-Platform App UI349 points · 253 comments
Nov 25, 2023Developers are not happy with .NET MAUI, but nobody in the team cares about it151 points · 121 comments
Aug 12, 2022Microsoft attempts to take MAUI name from Blue Systems16 points · 2 comments
May 19, 2020Name clash with KDE MAUI toolkit by Microsoft MAUI toolkit9 points
Mar 7, 2025MAUI is a scam4 points

8 more on Hacker News

Nov 10, 2020.NET Multi-Platform App UI (MAUI)4 points
Dec 28, 2024Maui multi-platform App UI framework for mobile and desktop3 points
Sep 30, 2023MSFTbot: “We've moved this issue to the Backlog milestone”3 points
May 19, 2020MAUI .NET Multi-Platform App UI3 points
Aug 11, 2022.NET maui: 1558 open issues after declared GA in May2 points
Feb 23, 2021First class Linux support developed by Microsoft #3392 points
May 20, 2020dotnet MAUI: A framework for building native device applications2 points
Aug 13, 2020.NET MAUI: Name Clash with Maui Linux and MauiKit1 point

On Bluesky · 3

Aug 15, 2025📦 dotnet / maui ⭐ 22,847 (+3) 🗒 C# .NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications… — @github-trending.bsky.social1 likes and repost
May 28, 2024📦 dotnet / maui ⭐ 21,692 (+6) 🗒 C# .NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications… — @github-trending.bsky.social1 likes and repost
Jan 8, 2024🔥 Hot Repo！ 🔥 (100+ new stars) 📦 dotnet / maui ⭐ 21,005 (+119) 🗒 C# .NET MAUI is the .NET Multi-platform App UI, a framework for… — @github-trending.bsky.social0 likes and reposts · 1 reply

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,774 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository29 other files it gives its agents.
- .github/copilot-instructions.mdCopilot instructions
- agentic-labelerSkill
- agentic-workflowsSkill
- analyze-sessionsSkill
- azdo-build-investigatorSkill
- ci-fixSkill
- code-reviewSkill
- dependency-flowSkill
- evaluate-pr-testsSkill
- find-regression-riskSkill
- find-reviewable-prSkill
- issue-triage-labelsSkill
- issue-triageSkill
- learn-from-prSkill
- otel-queriesSkill
- perf-analysisSkill
- pr-finalizeSkill
- pr-reviewSkill
- rebalance-ui-test-categoriesSkill
- release-readinessSkill
- review-test-failuresSkill
- run-device-testsSkill
- run-helix-testsSkill
- run-integration-testsSkill
- trace-regressionSkill
- try-fixSkill
- verify-tests-fail-without-fixSkill
- write-ui-testsSkill
- write-xaml-testsSkill

The file

We split this AGENTS.md into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Read .github/CONTRIBUTING.md and resolve current roles from eng/release-rollover.json.
line 17
Distinctive:
If the issue's intended release is unclear, ask a maintainer before selecting a base.
line 25

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

AGENTS.md

Contributor and agent branch routing

Choose the intended pull request base before starting a new change:

Work	Initial PR base
New features, API changes, and .NET 12 work, including .NET 12 fixes	`main`
.NET 11 servicing fixes	Literal `net11`, for review
Older servicing, release integration, infrastructure, or documentation	The branch designated for that work; do not guess

For a .NET 11 fix, start from net11, not next-major main. After approval, a maintainer manually retargets the PR to the active versioned inflight branch, validates CI on that final base, and merges there. Agents must not retarget or merge PRs. Individual fixes are not merged directly into net11; candidate integration is separate release work.

Read .github/CONTRIBUTING.md and resolve current roles from eng/release-rollover.json. Follow docs/ReleaseBranchWorkflow.md; do not hard-code an inflight SR number or treat historical net11.0 as literal net11. The highest retained netN.0 name is not the development target. Read the selected branch's global.json for its SDK; migration status does not change the intended PR route.

If the issue's intended release is unclear, ask a maintainer before selecting a base. Respect an explicitly assigned release branch and applicable Copilot instructions and path-specific instructions.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free