mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-06 06:37:29 +00:00
Miguel Ángel
f5033879f7
* fix(studio): keep an edit's preview waiting while the window draws no frames An edit that reloads the preview loads it hidden and swaps it in once it has drawn two frames. Its 45 s wait ran on the wall clock and paused only when the page reported itself hidden, but a window behind others on some Linux desktops draws no frames while still reporting visible. The swap then gave up and the old preview stayed on screen until the next edit. A wait budget in which no frame was drawn is no longer spent; the next frame restarts the full budget, as showing a hidden tab already does. * fix(studio): keep the frame-wait note in the budget comment
@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