maui-platform-backend

What problem does it solve?

This skill prevents stalled, error-prone platform work by giving a structured, end-to-end blueprint for implementing a new .NET MAUI backend in maui-labs, including core infrastructure, controls, Essentials services, and debugging guidance.

Core Features & Use Cases

• Backend scaffolding & project structure: Create a self-contained backend under platforms/[Platform.Name]/ with the expected .slnx, src/, samples/, and NuGet-packable project layout.
• Handler implementation roadmap: Follow phased steps to implement the base handler, dispatcher, MauiContext, app/window handlers, core layouts, and progressively add controls through interactive, navigation, and advanced features.
• Platform parity & reliability practices: Apply key architectural principles (MAUI owns layout, property mapper drives updates) and avoid known anti-patterns that commonly cause crashes or rendering hangs.
• Debugging workflow with DevFlow: Use the recommended audit and visual inspection loop to diagnose missing handlers, incorrect bounds, and property-mapping issues, including specific stop-signal guidance for stale process debugging.
• Extensibility gap workarounds: Address known MAUI gaps such as Alerts/Dialog via DispatchProxy and Essentials SetDefault() via reflection, plus guidance on other registration bypasses.

Quick Start

Use this skill to scaffold and implement a new platform backend under platforms/[Platform.Name]/, then validate handler rendering and property updates with MAUI DevFlow before adding the rest of the control surface.