What problem does it solve?
HyperFrames CLI eliminates the slow trial-and-error loop of building, validating, visually auditing, and rendering timeline-based HTML video compositions by providing a single repeatable dev loop.
Core Features & Use Cases
- Scaffold projects: Generate the correct file structure and starter composition assets using interactive or non-interactive initialization.
- Lint before you render: Catch composition issues like missing composition IDs, overlapping tracks, and unregistered timelines to prevent broken renders.
- Visual inspect along the timeline: Render in headless Chrome to detect text overflow, clipping, and off-canvas layout problems at specific timestamps or with timeline sweeps.
- Preview with hot reload: Serve the studio UI for rapid iteration and shareable project URLs during review.
- Render to deliverables: Produce MP4 or WebM outputs with controllable FPS/quality, strictness checks, and variable overrides for repeatable builds.
- Environment troubleshooting: Diagnose missing Node/FFmpeg/Chrome and manage bundled browser components for reliable execution.
- Asset preprocessing integration: Keep media preprocessing consistent by routing TTS/transcribe/remove-background to the hyperframes-media skill.
Quick Start
Run a full iteration loop by executing: npx hyperframes init my-video --non-interactive.