maui-devflow-onboard

Onboard MAUI DevFlow by aligning packages and MauiProgram.cs registration.

209|27|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/dotnet/maui-labs --skill maui-devflow-onboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-devflow-onboard
Source: https://github.com/dotnet/maui-labs/tree/main/plugins/dotnet-maui/skills/maui-devflow-onboard
Command: npx skills add https://github.com/dotnet/maui-labs --skill maui-devflow-onboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Onboarding MAUI DevFlow is error-prone because package flavors, Central Package Management, and MauiProgram.cs registration all need to be aligned for the user’s exact app setup.

Core Features & Use Cases

  • Choose the correct DevFlow package flavor for Standard MAUI, MAUI + Blazor WebView, GTK, and GTK + Blazor so the agent works with the right platform and UI stack.
  • Integrate DevFlow into MauiProgram.cs (Debug-only) using the correct registration API so DevFlow tooling is present during development without changing non-Debug behavior.
  • Verify installation with targeted CLI commands so the user can confirm the agent, UI tree, and connectivity before attempting deeper automation.

Quick Start

Run maui devflow diagnose, then maui devflow init if you still lack the DevFlow agent packages, and follow the integration steps in MauiProgram.cs for your project flavor.

Frequently Asked Questions about maui-devflow-onboard

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

FAQPage Schema
How do I add MAUI DevFlow to my MauiProgram.cs file?

To add MAUI DevFlow, you register the builder.AddMauiDevFlowAgent API inside your MauiProgram.cs file within an #if DEBUG block to ensure the tooling is active during development without altering release behavior.

How do I set up MAUI DevFlow with the Blazor WebView variant?

Setting up MAUI DevFlow with the Blazor WebView variant involves selecting the specific Blazor package flavor and registering the related Blazor tools alongside the DevFlow agent within the #if DEBUG configuration in MauiProgram.cs.

What is the correct way to verify a MAUI DevFlow installation?

Verifying a MAUI DevFlow installation requires running targeted CLI commands, specifically maui devflow diagnose, maui devflow wait, and UI tree inspection commands to confirm agent connectivity and functionality.

Does MAUI DevFlow support GTK projects and Central Package Management?

Yes, MAUI DevFlow supports GTK projects by applying specific activation patterns, and it integrates with Central Package Management repositories to align package references across your app setup.

Why does my MAUI DevFlow onboarding fail after running maui devflow init?

MAUI DevFlow onboarding often fails if package flavors and MauiProgram.cs registration are misaligned with your app setup, requiring you to run maui devflow diagnose to validate the exact integration steps.