dotnet-maui-doctor

Solid

Diagnoses and fixes .NET MAUI development environment issues. Validates .NET SDK, workloads, Java JDK, Android SDK, Xcode, and Windows SDK. All version requirements discovered dynamically from NuGet WorkloadDependencies.json — never hardcoded. Use when: setting up MAUI development, build errors mentioning SDK/workload/JDK/Android, "Android SDK not found", "Java version" errors, "Xcode not found", environment verification after updates, or any MAUI toolchain issues. Do not use for: non-MAUI .NET projects, Xamarin.Forms apps, runtime app crashes unrelated to environment setup, or app store publishing issues. Works on macOS, Windows, and Linux.

Web & Frontend 3,357 stars 247 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# .NET MAUI Doctor Validate and fix .NET MAUI development environments. All version requirements are discovered dynamically from NuGet APIs — never hardcode versions. ## When to Use - Setting up a new .NET MAUI development environment - Build errors mentioning missing SDKs, workloads, JDK, or Android components - Errors like "Android SDK not found", "Java version", or "Xcode not found" - Verifying environment health after SDK or OS updates ## When Not to Use - Non-MAUI .NET projects (use standard .NET SDK troubleshooting instead) - Xamarin.Forms apps (different toolchain and workload requirements) - Runtime app crashes unrelated to environment setup - App store publishing or signing issues - IDE-specific issues (Visual Studio or VS Code configuration) ## Important: .NET Version Currency Your training data may be outdated regarding .NET versions. .NET ships new major releases annually (November). Always check the releases-index.json (Task 2) to discover the **latest active major release** — do not assume your training data reflects the current version. For example, if you know about .NET 9.0 but the releases index shows .NET 10.0 as active, use .NET 10.0. ## Inputs - A development machine running macOS, Windows, or Linux - Shell access (Bash on macOS/Linux, PowerShell on Windows) - Internet access for NuGet API queries and SDK downloads - Admin/sudo access may be required for installing SDKs and workloads - **Bash prerequisites**: `curl`, `jq`, and `unzip` (macOS/Linu...

Details

Author
dotnet
Repository
dotnet/skills
Created
4 months ago
Last Updated
today
Language
C#
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category