skills.rest
dotnet
dotnetOFFICIAL
Explore all skills by this author →
Website𝕏@dotnetfdnGitHub

maui-devflow-debug

Build, deploy, and inspect .NET MAUI apps via DevFlow for runtime debugging.

209|27|Updated Mar 10, 2026
Search Tags:#devflow#maui#ui inspection#android adb#automationid#blazor cdp#debugging loop
One-click install
npx skills add https://github.com/dotnet/maui-labs --skill maui-devflow-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maui-devflow-debug
Source: https://github.com/dotnet/maui-labs/tree/main/plugins/dotnet-maui/skills/maui-devflow-debug
Command: npx skills add https://github.com/dotnet/maui-labs --skill maui-devflow-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of getting stuck while debugging a .NET MAUI app that already has MAUI DevFlow integrated, where you need fast build → deploy → connect → inspect → fix iteration across devices and emulators.

Core Features & Use Cases

  • DevFlow connection + reachability verification: Wait for the agent, confirm runtime identity, and gate UI actions on successful connectivity rather than guesses.
  • UI inspection and interaction loop: Query the visual tree, prefer AutomationId-first targeting, and capture evidence (like screenshots and logs) to drive precise fixes.
  • Targeted recovery for common DevFlow connectivity failures: Recover from broker/port/ADB forwarding issues, including Android emulator network forwarding and “agent not connecting” scenarios.
  • Blazor WebView/CDP debugging support: Use DevFlow’s WebView inspection and CDP-related commands as part of the same debugging workflow for hybrid content.

Quick Start

Use the skill to debug your existing MAUI DevFlow-enabled app by running build, deploying, selecting the right device, waiting for the DevFlow agent, then inspecting the UI tree and interacting with controls by AutomationId.

Frequently Asked Questions about maui-devflow-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my MAUI DevFlow agent not connecting on the Android emulator?▼

MAUI DevFlow agent connectivity failures on Android often stem from broker, port, or ADB forwarding issues. You can recover by applying targeted Android emulator network forwarding and connectivity guidance while coordinating the maui devflow CLI with your build targets.

How do I inspect the visual tree of a running MAUI app across iOS and Windows?▼

You can inspect the visual tree of a running MAUI app across iOS, Windows, and other platforms by using the DevFlow-driven inspection loop. This involves querying the visual tree and capturing screenshots to drive precise UI fixes during active debugging.

Can I use Chrome DevTools Protocol to debug a Blazor WebView in MAUI?▼

Yes, you can debug Blazor WebView content in MAUI using DevFlow’s WebView inspection and CDP-related commands. This support is integrated directly into the same debugging workflow used for native UI interaction.

What's the best way to target UI controls during MAUI runtime troubleshooting?▼

The best way to target UI controls during MAUI runtime troubleshooting is an AutomationId-first approach. Using the DevFlow inspection loop, you query the visual tree and interact with controls by their AutomationId for precise identification.

Do I need a fully integrated MAUI DevFlow project to use the debugging loop?▼

Yes, this debugging loop requires an already-integrated .NET MAUI app with MAUI DevFlow enabled. It coordinates the maui devflow CLI with dotnet run/build targets to actively troubleshoot runtime UI and agent connectivity issues across devices.

How does the MAUI DevFlow build deploy and inspect cycle work?▼

The MAUI DevFlow cycle works by iterating through build, deploy, and connect steps, followed by DevFlow-driven inspection. It waits for the agent, confirms runtime identity, and gates UI actions on successful connectivity before capturing logs and screenshots.

Related Skills

Explore More Software Engineering Skills→
davidortinaudavidortinau
28

maui-ai-debugging

Build, deploy, inspect, and debug .NET MAUI and MAUI Blazor Hybrid applications.

Community
Advanced
parisgroup-aiparisgroup-ai
1

design-critic

Analyze and auto-fix visual design issues in web applications.

Official
Advanced
aritchiearitchie
3

maui-devflow-debug

Automate build, deploy, inspect, and fix cycles for MAUI apps with DevFlow.

Community
Advanced
microsoftmicrosoft
188.5k

launch

Launch Code OSS with debugging and automate its UI via Chrome DevTools Protocol.

Official
Advanced