mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-20 20:38:34 +00:00
A new page per operation, each with a recording of the gesture and the rule it follows, plus the question that picks between them: what has to stay fixed. Slip leads with the analogy rather than the mechanism, because "changes which part of the source plays" is the sentence that left readers guessing what moves. It is sliding a photo behind a picture frame. The timeline page now hands off where trimming is introduced, and the four keys join the editing table on the shortcuts page. Studio itself gets the link. It sits at the top of the shortcuts panel, which is the editor's only help surface and is already where someone goes when they cannot remember what a tool does. Top, not bottom: the panel scrolls, and a link below the fold is a link nobody finds. It points at the Studio tab index rather than a deep link, because pages move and a dead link inside the editor is worse than a general one. Media lives in docs/images/studio (gitignored, served from the CDN) and needs scripts/upload-docs-images.sh before the page renders.
@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