mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 06:19:21 +00:00
VstSection's chain-file writes (add/remove effect, and the 2.5s native-editor-state poll from the earlier persistence fix) never stamped domEditSaveTimestampRef, unlike every other save path in the app. The studio's file-watcher reloads the whole preview iframe for any file change older than 4s relative to that stamp — so every poll-triggered write reloaded the preview roughly every 2.5 seconds while a plugin's native editor was open, re-issuing load-chain and replacing the plugin instance the editor was still live-mutating with a fresh default-state one. Parameter tweaks in the native GUI were being silently discarded from the actually-streaming/rendering plugin. Thread domEditSaveTimestampRef from StudioRightPanel through PropertyPanel into VstSection and stamp it after every successful chain-file PUT, matching the convention every other save path already follows.
@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