mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 22:58:02 +00:00
Review findings on the playback gate: - Ceilings are recorded on Chrome 153, the runner's browser. The script now stops with a clear message when it runs another Chrome major. - Frames were read from the first renderer main thread in the trace; on Chrome 153 that is not the page's, so no frames came out. The thread producing frames is used now, and zero frames fail loudly instead of passing the CPU check with a NaN median. - Play goes through Studio's Space shortcut and pause through the runtime's player, which both builds share, so a stopped film or a renamed control cannot throw before the JSON is written. - Every timeline seek is counted, silent ones included (3 per frame on main), and the layer count is named for when it is read (paused). - Rounds alternate which build goes first, and a failed base build no longer skips the timeline gate; playback is then counted, not timed.
@hyperframes/studio
Browser-based composition editor UI for Hyperframes. Provides a visual timeline, code editor, and live preview for building video compositions.
Install
npm install @hyperframes/studio
What it does
The studio is a React application with:
- Visual timeline — drag, resize, and arrange elements on tracks
- Code editor — edit HTML and GSAP scripts with CodeMirror (syntax highlighting, autocomplete)
- Live preview — see changes in real time as you edit
- Composition inspector — view and modify element properties
Development
The studio is embedded in the hyperframes preview command. To develop the studio UI itself:
cd packages/studio
bun run dev # Start Vite dev server
bun run build # Build for production
bun run typecheck # Type-check
Tech stack
- React 19, Zustand 4/5 (state management; development uses Zustand 5)
- CodeMirror 6 (editor)
- Tailwind CSS (styling)
- Vite (bundler)
- Phosphor Icons
Documentation
Full documentation: hyperframes.heygen.com/packages/studio
Related packages
@hyperframes/core— types and parsers used by the editorhyperframes— CLI that serves the studio viahyperframes preview