maui-hot-reload-diagnostics

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

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-hot-reload-diagnostics-heldercsousa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-hot-reload-diagnostics
Source: https://github.com/heldercsousa/MyVocaList/tree/main/.claude/skills/maui-hot-reload-diagnostics
Command: npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-hot-reload-diagnostics-heldercsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnose and troubleshoot .NET MAUI Hot Reload failures across all UI approaches (XAML, MauiReactor, C# Markup, Blazor Hybrid), enabling faster developer iteration and fewer wasted debug cycles.

Core Features & Use Cases

  • Automated diagnostics collects environment details, hot reload configuration, and encoding status to identify root causes.
  • Cross-tool support covers both Visual Studio and VS Code workflows, with guidance for XAML and C# hot reload paths.
  • Remediation guidance provides concrete steps, checks, and best practices to restore hot reload reliability in MAUI projects.

Quick Start

Run the hot reload diagnostics to collect environment, encoding, and configuration details.

Frequently Asked Questions about maui-hot-reload-diagnostics

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

FAQPage Schema
Why is .NET MAUI hot reload not working in my project?

MAUI hot reload failures often stem from incorrect environment variables, file encoding issues, or misconfigured project settings across XAML, MauiReactor, C# Markup, or Blazor Hybrid. Running diagnostics collects these details to identify the exact root cause.

How do I diagnose XAML hot reload failures in Visual Studio?

You can diagnose XAML hot reload failures by collecting environment info, checking hot reload settings, and verifying file encoding status for Debug builds. This diagnostic workflow applies to both Visual Studio and VS Code environments.

Does MAUI hot reload support Blazor Hybrid and C# Markup?

Yes, hot reload diagnostics support Blazor Hybrid and C# Markup alongside XAML and MauiReactor. The diagnostic process collects specific setup configurations for these UI approaches to provide targeted remediation steps.

What environment variables affect .NET MAUI hot reload?

Environment variables influence hot reload behavior by configuring how the runtime applies changes during debugging. Diagnostics gather these variables along with encoding status and project configuration to detect misconfigurations causing failures.

Can I use hot reload diagnostics with VS Code for MauiReactor?

Yes, hot reload diagnostics support VS Code workflows for MauiReactor projects. The diagnostic process collects environment details, encoding checks, and MauiReactor setup configurations to troubleshoot hot reload issues in Debug builds.

How to fix MAUI hot reload when code changes are not applying?

Fix hot reload issues by running diagnostics to check environment info, encoding status, and project configuration. The collected data identifies configuration gaps or encoding problems, enabling concrete remediation steps to restore reliable hot reload.