mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 06:19:21 +00:00
Finding 1 of the final whole-branch review: opening a plugin's native editor and tweaking a parameter only ever mutated the sidecar's live in-memory plugin instance — nothing read the updated state back and wrote it into the track's .vstchain.json, so `hyperframes render` silently bounced stale/default state instead of what the user heard in preview. There is no "editor closed" event on the wire (the native window closes via its own OS chrome), so VstSection now polls vstHost.getState every 2.5s while an editor is presumed open (since the last "Open editor" click, until the track changes or the section unmounts) and PUTs the chain file via the existing writeChainFile helper when state actually changed. A best-effort final flush runs from the same effect's cleanup on unmount/navigate-away. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@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