Files
hyperframes/packages/studio
Daniel McSheehy d787681d12 feat(studio): zoom the timeline to the selected clips (#5824)
* feat(studio): zoom the timeline to the selected clips

Toolbar action and Z fit the selected clips to the visible width, with the
range margin, and stay disabled until something is selected.

* fix(studio): gate zoom-to-selection on a resolvable clip

The scroll clamp already lives in the timeline zoom request. Drop the
unused copy, and disable the button and Z unless the selection matches
a timeline clip with duration. A collapsed timeline cancels
zoomTimelineToRange instead of laying out a percent the view cannot show.

* fix(studio): keep a zoom step when the timeline is collapsed

A collapsed timeline has no track for a range zoom, so zoom in and out
step the percent directly. Z is consumed only when that zoom actually
starts, and zoom-to-selection no longer builds the span three times.

* ci: retrigger checks after workflow approval

The approved run was cancelled during checkout, so the required checks
never executed.
2026-10-25 23:22:54 +00:00
..
2026-10-25 20:50:21 +00: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