gum-runtime-hot-reload

Watch Gum source file changes and rebuild UI trees at runtime.

597|79|Updated Mar 11, 2015
One-click install
npx skills add https://github.com/vchelaru/Gum --skill gum-runtime-hot-reload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gum-runtime-hot-reload
Source: https://github.com/vchelaru/Gum/tree/main/.claude/skills/gum-runtime-hot-reload
Command: npx skills add https://github.com/vchelaru/Gum --skill gum-runtime-hot-reload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of updating a Gum-powered UI in a running game without requiring a restart, enabling seamless iteration and faster development cycles.

Core Features & Use Cases

  • Runtime Hot Reloading: Automatically detects file changes in Gum source files and rebuilds the UI element tree at runtime.
  • Debounced Reload Pipeline: Efficiently coalesces multiple rapid file changes into a single safe reload operation with font cache management.
  • Use Case: When working on Gum UI elements or related runtime code, use this Skill to observe live changes without stopping your game, improving debugging and design workflows.

Quick Start

Load the gum-runtime-hot-reload skill to get detailed guidance for enabling and managing Gum runtime hot reload in your game project.

Frequently Asked Questions about gum-runtime-hot-reload

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

FAQPage Schema
How do I hot reload Gum UI elements in a running MonoGame project?

To hot reload Gum UI elements in a running MonoGame project, use a file watcher to detect source changes and rebuild the UI tree at runtime without restarting. This enables seamless iteration and faster development cycles.

What is the best way to prevent repeated UI reloads when saving multiple Gum files?

The best way to prevent repeated UI reloads is to apply a debounced reload pipeline. Debouncing coalesces rapid file changes into a single safe reload operation, preventing performance issues and UI flickering.

Does Gum runtime hot reload work with frameworks other than MonoGame?

Yes, Gum runtime hot reload works with FNA, Raylib, and similar frameworks alongside MonoGame. It applies file watching and debounced reload requirements across these platforms to ensure robust runtime UI updates.

How do I handle font cache updates during a Gum UI hot reload?

Handling font cache updates during a Gum UI hot reload requires integrating cache management into the debounced reload pipeline. This safely manages font cache clearing to ensure text elements render correctly without memory leaks.

Why does my Gum UI file watcher fail to trigger a runtime reload?

A Gum UI file watcher may fail to trigger a runtime reload if platform gating restrictions are active or reload event subscriptions are missing. Proper setup requires subscribing to file watcher events and verifying platform compatibility.