debug-menu

Provide an in-app debug menu for iOS DEBUG builds using SwiftUI.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/ano4l/SiteRent --skill debug-menu-ano4l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-menu
Source: https://github.com/ano4l/SiteRent/tree/main/skills/generators/debug-menu
Command: npx skills add https://github.com/ano4l/SiteRent --skill debug-menu-ano4l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often need quick, in-app access to debugging tools without rebuilding or leaving the app. The Debug Menu Generator provides an on-device, toggleable panel that exposes feature flags, environment switching, network logs, cache operations, crash testing, and diagnostic exports, all gated behind a DEBUG build.

Core Features & Use Cases

  • In-app feature flag toggles to experiment with new capabilities without code changes.
  • Environment switching to test against development, staging, and production endpoints in one place.
  • Network log viewer to inspect recent requests, responses, and timing for QA and debugging.
  • Cache controls to clear HTTP and image caches during development and performance testing.
  • Diagnostic export to generate a shareable report of device, app, and environment state.
  • Use Case: a developer toggles a feature flag, switches to staging, reproduces an API error, and exports a diagnostic bundle for the team.

Quick Start

Open a development build and trigger the debug menu via shake or the hidden tap.

Frequently Asked Questions about debug-menu

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

FAQPage Schema
How do I add an in-app debug menu for feature flags in SwiftUI?

An in-app debug menu for feature flags in SwiftUI provides a toggleable panel to switch capabilities on or off during development. This tool generates a developer-only interface activated by shake or hidden-tap, gated behind the #if DEBUG flag.

Can I inspect network logs and switch environments on an iOS device without rebuilding?

Yes, you can inspect network logs and switch environments on an iOS device without rebuilding by using an on-device debug menu. It exposes modular sections to view recent requests, responses, and timing, while toggling between development, staging, and production endpoints.

What is a shake-to-debug panel and when do I need it for iOS development?

A shake-to-debug panel is an in-app developer tool triggered by shaking the device to access debugging features. You need it for iOS development when you require rapid, on-device access to feature flags, cache controls, and diagnostics without leaving the app.

Does this debug menu tool work in release builds or only in DEBUG builds?

This debug menu tool works only in DEBUG builds. It is strictly gated by the #if DEBUG flag to ensure developer-only features like environment switching, crash testing, and diagnostic exports are never exposed in production release builds.

How do I clear HTTP and image caches during iOS development testing?

To clear HTTP and image caches during iOS development testing, you use the cache controls section within a debug menu. This on-device panel provides cache operations to wipe HTTP and image caches during development and performance testing.

How do I export a diagnostic report of app and environment state from an iOS device?

To export a diagnostic report of app and environment state from an iOS device, you use the diagnostic export feature in a debug menu. It generates a shareable report containing device, app, and environment state for team debugging.