Files
Miguel Ángel 5aed93b5c6 test(studio): the playback gate reports timing and fails only on counts
Timing was meant to be reporting-only, but a ratio over 1.15x still exited
1 and turned the job red; identical builds cross it in 31% of draws. It now
prints a warning (a workflow warning in CI) and exits 0. Only the counts,
a Chrome other than the ceilings', or a broken run fail the step.

On a Chrome mismatch the evidence JSON is printed before the exit, so new
ceilings can be taken from it. The mismatch rule has one owner,
perf-ratchet.mjs browserMismatch, which lower, the check notes and the
script all call. playbackVerdict is exported and tested: a 1.3x ratio
exits 0 with a warning, a mismatch exits 1, and a count rise fails the
ratchet.
2026-09-27 16:55:55 -04:00
..

@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 19, Zustand 4/5 (state management; development uses Zustand 5)
  • CodeMirror 6 (editor)
  • Tailwind CSS (styling)
  • Vite (bundler)
  • Phosphor Icons

Documentation

Full documentation: hyperframes.heygen.com/packages/studio