mirror of https://github.com/heygen-com/hyperframes.git synced 2026-11-15 13:58:20 +00:00

Files

T

Miguel Ángel a46412ee07 fix(studio): a preview reload writes the composition as it is now, not as it was when it asked (#6998 )

* fix(studio): a preview swap writes the composition as it is now, not as it was when it asked

Claude-Session: https://claude.ai/code/session_01BzWPCkrNkiYrpRYeqVmKyK

* fix(studio): a shadow reload that a write outran loads the file again

Claude-Session: https://claude.ai/code/session_01BzWPCkrNkiYrpRYeqVmKyK

* fix(studio): count the project's revision once per write, not again on its echo

Claude-Session: https://claude.ai/code/session_01BzWPCkrNkiYrpRYeqVmKyK

* refactor(studio): move the swap freshness check next to the swap it guards

* refactor(studio): name the refetch bound instead of explaining it

2026-11-02 09:52:07 +00:00

frontend

…

public

…

src

fix(studio): a preview reload writes the composition as it is now, not as it was when it asked (#6998 )

2026-11-02 09:52:07 +00:00

tests

fix(studio): a preview reload writes the composition as it is now, not as it was when it asked (#6998 )

2026-11-02 09:52:07 +00:00

.gitignore

feat(studio): make agent edits live and explicit (#3581 )

2026-09-02 01:11:13 -04:00

AGENTS.md

test(studio): edit accuracy screenshots are viewport-only and taken in the confirmation re-runs (#6795 )

2026-10-30 06:07:59 +00:00

index.html

feat(studio): a light and dark theme toggle in the header that remembers the choice (#4839 )

2026-10-01 08:44:57 -07:00

package-subpaths.json

perf(studio): a host's first screen can import Studio's UI and Player without the editor (#4650 )

2026-09-28 15:15:00 +00:00

package.json

chore: release v0.9.2 (#6994 )

2026-11-02 08:42:46 +00:00

README.md

docs(studio): align stack note with package dependency contract (#3675 )

2026-09-04 19:53:07 -04:00

tsconfig.json

perf(packages): ship npm packages without source maps and guard their size in CI (#5403 )

2026-10-10 09:04:47 +00:00

tsconfig.lib.json

…

tsup.config.ts

feat(cli): beats tracks the music with the TypeScript beat tracker, without Chrome (#5634 )

2026-10-15 06:23:03 +00:00

vite.adapter.projects.test.ts

fix(studio): open projects named with a colon and keep preview assets for names with # (#4829 )

2026-09-30 23:21:53 -07:00

vite.adapter.proxy.test.ts

…

vite.adapter.render.test.ts

feat(studio): support GIF export with loop count (#5593 )

2026-10-26 14:57:55 +00:00

vite.adapter.signature.test.ts

fix(studio): invalidate the preview signature off the watcher that sees project writes (#3364 )

2026-08-21 19:13:37 -04:00

vite.adapter.ts

feat(engine): render sets a keyframe interval and a peak bitrate cap (#6444 )

2026-10-27 00:29:06 +00:00

vite.browser.test.ts

fix(studio): opening the thumbnail browser no longer stalls the server to read its version (#6931 )

2026-11-01 15:43:24 +00:00

vite.browser.ts

fix(studio): opening the thumbnail browser no longer stalls the server to read its version (#6931 )

2026-11-01 15:43:24 +00:00

vite.browserVersion.test.ts

test(studio): retain Chrome launch diagnostics (#6077 )

2026-10-23 01:55:52 +00:00

vite.config.test.ts

feat(studio): export the header logo, button sizes and a stable styles.css subpath (#4197 )

2026-09-19 19:06:01 -04:00

vite.config.ts

feat(cli): beats tracks the music with the TypeScript beat tracker, without Chrome (#5634 )

2026-10-15 06:23:03 +00:00

vite.preview-config.test.ts

feat(cli): run a managed background preview in every launch mode (#3310 )

2026-08-19 17:02:44 -04:00

vite.preview-config.ts

feat(cli): run a managed background preview in every launch mode (#3310 )

2026-08-19 17:02:44 -04:00

vite.preview-watch.test.ts

fix(studio): reload the preview only when a file it loaded changes (#4570 )

2026-09-27 10:05:53 +00:00

vite.preview-watch.ts

fix(studio): reload the preview only when a file it loaded changes (#4570 )

2026-09-27 10:05:53 +00:00

vite.producer.test.ts

…

vite.producer.ts

…

vite.request-body.test.ts

…

vite.request-body.ts

…

vite.request-signal.test.ts

feat(studio): preview timeline track insertion (#4907 )

2026-10-02 08:04:29 -07:00

vite.request-signal.ts

feat(studio): preview timeline track insertion (#4907 )

2026-10-02 08:04:29 -07:00

vite.studio-server-module.test.ts

feat(studio): make agent edits live and explicit (#3581 )

2026-09-02 01:11:13 -04:00

vite.studio-server-module.ts

feat(studio): make agent edits live and explicit (#3581 )

2026-09-02 01:11:13 -04:00

vite.studioMotion.test.ts

…

vite.studioMotion.ts

…

vite.thumbnail.test.ts

…

vite.thumbnail.ts

…

vitest.config.ts

fix(studio): catch up the preview after missed file changes (#5126 )

2026-10-07 07:32:16 +00:00

README.md

@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

@hyperframes/core — types and parsers used by the editor
hyperframes — CLI that serves the studio via hyperframes preview

README.md

@hyperframes/studio

Install

What it does

Development

Tech stack

Documentation

Related packages