mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 07:05:28 +00:00
The last of the schematic direction, translated to a one-column panel rather than the wide diagram the review page draws. **Both ends named.** IN — this track, OUT — to mix. Two lines, and they change what the rack is: without them the order reads as a list, and a list is the one reading that makes "move up" look cosmetic. It is the most consequential control in the panel — chain order is audible. **Every step numbered**, counted over what the rack SHOWS rather than over the chain. The carve's filters and an EQ's bands live inside their own modules, so counting raw nodes would leave the visible rack jumping from 02 to 07, and the numbers would read as a bug rather than a position. **A preset draws as one thing.** Applying one used to drop five loose rows in with nothing saying they arrived together — the same failure the carve module exists to fix, one level down. Consecutive nodes only: a preset pulled apart by a reorder is no longer a unit, and a bracket around the gap would claim an adjacency the signal path does not have. Falsified: numbering by chain index fails the path test, and grouping a preset's nodes regardless of adjacency fails the run test. studio 3695 passing, 18 todo.
@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