maui-hot-reload-diagnostics

Diagnose .NET MAUI Hot Reload failures by collecting logs and verifying configuration.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-hot-reload-diagnostics-seydakaratekeli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-hot-reload-diagnostics
Source: https://github.com/seydakaratekeli/KamPay3/tree/main/KamPay/.github/skills/maui-hot-reload-diagnostics%20-%20Kopyala
Command: npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-hot-reload-diagnostics-seydakaratekeli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dotnet, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Diagnoses why .NET MAUI Hot Reload (XAML, C# Hot Reload, or Blazor Hybrid) is not applying UI changes and provides actionable checks and fixes to restore iterative development flow in Visual Studio and VS Code.

Core Features & Use Cases

  • Guided checklist to identify whether XAML Hot Reload or C# Hot Reload is failing and what to re-trigger.
  • Encoding and environment validation, including checks for UTF-8 with BOM on .cs files and recommended env vars for detailed logging.
  • Framework-specific guidance for MauiReactor, CommunityToolkit.Maui.Markup (C# Markup), and Blazor Hybrid limitations and requirements.
  • Automated diagnostics script that collects dotnet info, workloads, env vars, encoding checks, MetadataUpdateHandler presence, MauiReactor setup, project configuration, and VS Code settings.
  • Reference documentation describing environment variables, MetadataUpdateHandler patterns, and diagnostic commands to gather binary logs and reproduce issues.

Quick Start

Run the included diagnostics script to collect hot reload logs, encoding checks, env vars, and project hints, then attach the output when reporting the issue.

Frequently Asked Questions about maui-hot-reload-diagnostics

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

FAQPage Schema
Why does .NET MAUI Hot Reload not apply UI changes in Visual Studio during Debug runs?

.NET MAUI Hot Reload may fail if the project is not in Debug configuration, .cs files lack UTF-8 with BOM encoding, or MetadataUpdateHandler is missing. This diagnostic process collects logs and verifies environment variables to identify the root cause.

How do I diagnose XAML or C# Hot Reload failures in MAUI applications?

You can diagnose MAUI Hot Reload failures by running an automated diagnostics script that collects dotnet binary logs, workload info, environment variables, and project configuration details to pinpoint why XAML or C# UI changes are not appearing.

Does .NET MAUI Hot Reload work with MauiReactor and Blazor Hybrid scenarios?

Yes, MAUI Hot Reload diagnostics support MauiReactor, CommunityToolkit.Maui.Markup, and Blazor Hybrid scenarios. The process checks for MauiReactor RuntimeHostConfigurationOption and provides framework-specific guidance for limitations and requirements.

What environment variables and encoding settings are required for MAUI Hot Reload to function properly?

MAUI Hot Reload requires UTF-8 with BOM encoding for .cs files, proper Debug configuration, recommended environment variables for detailed logging, and MetadataUpdateHandler presence. The diagnostic checks verify these settings to restore iterative development flow.

How do I collect dotnet binary logs to troubleshoot MAUI Hot Reload issues?

You can collect dotnet binary logs by running the included diagnostics script, which gathers dotnet info, workloads, environment variables, and project hints. Attach the output when reporting issues for root-cause analysis and reproduction.

Can I use MAUI Hot Reload diagnostics in VS Code or is it limited to Visual Studio?

MAUI Hot Reload diagnostics work in both Visual Studio and VS Code. The diagnostic script collects VS Code settings alongside project configuration and environment variables to identify why UI changes are not applying during Debug runs.