workflow-debug-render

What problem does it solve?

This workflow helps identify and fix rendering issues in Helios compositions, such as black frames, missing assets, or timing glitches, ensuring reliable visual output.

Core Features & Use Cases

• Diagnostics: Leverages the Renderer.diagnose() method to produce a structured report of environment capabilities and potential failures.
• Trace Debugging: Enables Playwright traces to capture frame-by-frame behavior for in-depth analysis.
• Stability Coordination: Guides how to register stability checks (fonts, images) to avoid assets popping in mid-render.
• Live Debugging: Supports headed mode to watch the rendering process in real-time during development.
• Common Errors: Provides guidance on resolving issues like network idle and timeouts that affect render stability.

Quick Start

Run the workflow to diagnose a failing Helios render by executing the diagnose flow and reviewing the produced report.