broadway-debug

Debug GTK4 application UIs via Broadway HTML5 and Playwright MCP.

8|2|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/chebizarro/nostrc --skill broadway-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: broadway-debug
Source: https://github.com/chebizarro/nostrc/tree/main/skills/broadway-debug
Command: npx skills add https://github.com/chebizarro/nostrc --skill broadway-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables rapid, closed-loop debugging of GTK4 application UIs directly within a browser, streamlining the identification and resolution of visual and interaction bugs without leaving the agent session.

Core Features & Use Cases

  • Persistent Browser Sessions: Maintain browser connections across application rebuilds and restarts.
  • Live UI Inspection: Inspect UI elements, capture screenshots, and analyze accessibility trees.
  • Widget Manipulation: Interact with UI elements programmatically via Playwright or GTK test utilities.
  • Use Case: Quickly iterate on UI changes for applications like gnostr or gnostr-signer by rebuilding the app and immediately seeing the updated UI in a persistent browser session, allowing for rapid visual and functional verification.

Quick Start

Start the persistent Broadway daemon by running the command: ./scripts/run-broadway.sh

Frequently Asked Questions about broadway-debug

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

FAQPage Schema
How do I debug a GTK4 application UI in a browser?▼

This Skill facilitates closed-loop UI debugging for GTK4 applications by using the Broadway HTML5 backend alongside Playwright MCP to inspect elements, capture screenshots, and analyze accessibility trees directly in a persistent browser session.

Can I keep my browser session open across GTK4 application rebuilds?▼

Yes, persistent browser sessions maintain active connections across application rebuilds and restarts, allowing you to immediately see updated UI changes without needing to reconnect or restart the Broadway daemon.

What do I need to use Broadway for live UI debugging?▼

To use Broadway for live UI debugging, you need GTK4 with Broadway support, a built application binary, and a connected Playwright MCP server to enable live visual inspection and interaction testing.

How does Playwright work with GTK4 Broadway for widget manipulation?▼

Playwright works with the GTK4 Broadway backend by interacting with UI elements programmatically, allowing you to manipulate widgets and trigger interactions directly within the browser environment for rapid testing.

What is the best way to iterate on visual bugs in a gnostr application?▼

The best way to iterate on visual bugs in gnostr applications is to run the Broadway daemon, rebuild the app, and immediately verify the updated UI in a persistent browser session using accessibility snapshot inspection.

Does GTK4 Broadway support accessibility tree inspection for UI debugging?▼

Yes, GTK4 Broadway supports accessibility tree inspection, allowing you to analyze accessibility snapshots alongside capturing screenshots to identify and resolve visual and interaction bugs efficiently.