mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
A rich-text patch adds spans, and it left them without their stable ids. The next preview request minted them and wrote the file a second time — after Studio had recorded the edit in its history. The recorded "after" no longer matched the bytes on disk, so the content check refused and undo reported the file as changed outside Studio. Every colour applied to a run of characters and every text layer added poisoned the history the same way. The patch now mints those ids itself, with the same function the later pass would have used, in the bytes it writes and hands back. The clip split already did this for its clone and its comment names this exact failure. Undo and redo also move out of the header and into the timeline toolbar, left of the selection tool. They act on the timeline and the canvas; the header is for the project. They read the shell optionally, so the standalone timeline the player package exports still mounts without a project.
@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 18/19, Zustand (state management)
- 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