maui-hot-reload-diagnostics

Diagnose .NET MAUI Hot Reload issues across XAML, MauiReactor, C# Markup, and Blazor Hybrid.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Petelids/Sudoku --skill maui-hot-reload-diagnostics-petelids
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-hot-reload-diagnostics
Source: https://github.com/Petelids/Sudoku/tree/main/skills/maui-skills/maui-hot-reload-diagnostics
Command: npx skills add https://github.com/Petelids/Sudoku --skill maui-hot-reload-diagnostics-petelids

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnose and troubleshoot .NET MAUI Hot Reload issues across XAML, MauiReactor, C# Markup, and Blazor Hybrid workflows to save debug time and improve UI iteration.

Core Features & Use Cases

  • Provides a structured diagnostic workflow for hot reload failures, covering environment configuration, encoding checks, and per-IDE settings.
  • Guides on MauiReactor, C# Markup, and Blazor Hybrid hot reload specifics, with practical remediation steps.
  • Uses a diagnostic script to collect environment data and log outputs for faster issue reproduction.

Quick Start

Run the diagnose-hot-reload.sh script from the repository root to collect diagnostics and start troubleshooting hot reload problems.

Frequently Asked Questions about maui-hot-reload-diagnostics

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

FAQPage Schema
How do I diagnose .NET MAUI Hot Reload issues not working in XAML or C# Markup?

Diagnose .NET MAUI Hot Reload failures by running the diagnostic script to collect environment data and logs, verifying UTF-8 with BOM encoding, and checking IDE-specific settings for XAML and C# Markup workflows.

Why does Hot Reload fail in Debug configurations with a debugger attached?

Hot Reload fails in Debug configurations due to missing environment variables, improper UTF-8 BOM encoding, or incorrect Visual Studio and VS Code settings, requiring diagnostic logs to isolate platform-specific behaviors.

Does MAUI Hot Reload work with Blazor Hybrid and MauiReactor?

MAUI Hot Reload diagnostics support Blazor Hybrid and MauiReactor by checking reference scaffolding, verifying environment variables, and providing targeted remediation steps for platform-specific hot reload behaviors.

What's the best way to troubleshoot MAUI Hot Reload failures across different IDEs?

Troubleshoot MAUI Hot Reload failures by running a diagnostic script that validates Visual Studio and VS Code hot reload settings, verifies UTF-8 BOM encoding, and collects environment variables and logs for faster issue reproduction.

Do I need UTF-8 with BOM encoding for MAUI Hot Reload to function properly?

Yes, UTF-8 with BOM encoding is required for proper MAUI Hot Reload functionality, as incorrect file encoding can prevent hot reload mechanisms from detecting and applying changes across XAML, C# Markup, and MauiReactor workflows.

What are common limitations when using MAUI Hot Reload diagnostics?

MAUI Hot Reload diagnostics are limited to Debug configurations with an attached debugger, requiring correct Visual Studio and VS Code settings, proper environment variables, and reference scaffolding for MauiReactor and C# Markup workflows.