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

T

Vance IngallsandClaude Opus 4.6 50f55c9759 feat(skill): add house style guide with motion defaults, palettes, and anti-defaults

When no visual-style.md is provided, compose-video now follows house-style.md
for professional output quality. Includes:

- Motion: easing variety, timing, entrance patterns, choreography
- Sizing: text scale contrast, element fill, travel distance
- Visual depth: gradient/shadow/texture guidance
- Typography: weight contrast, tracking, case
- Anti-defaults: table of generic AI patterns to avoid
- 72 curated color palettes across 9 categories
- Content interpretation: generate real content, not prompt text

Eval-validated across 5 iterations with 50+ test compositions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-26 11:06:23 -07:00

.github

chore(github): convert issue templates to YAML forms and disable blank issues

2026-03-26 05:45:41 +00:00

docs

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

packages

fix(cli): improve --help documentation and add --yes/--check to upgrade

2026-03-26 11:06:23 -07:00

scripts

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

skills

feat(skill): add house style guide with motion defaults, palettes, and anti-defaults

2026-03-26 11:06:23 -07:00

.editorconfig

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.env.example

initial code (#2 )

2026-03-21 22:43:56 -07:00

.gitattributes

initial code (#2 )

2026-03-21 22:43:56 -07:00

.gitignore

feat(cli): add whisper transcription and template improvements (#53 )

2026-03-26 11:05:15 -07:00

.oxfmtrc.json

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.oxlintrc.json

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.prettierignore

test(regression): add editor-agent-prod regression fixture

2026-03-24 15:33:13 -04:00

bun.lock

fix(cli): resolve npx hyperframes from inside monorepo (#47 )

2026-03-26 10:25:19 -07:00

CODE_OF_CONDUCT.md

initial code (#2 )

2026-03-21 22:43:56 -07:00

commitlint.config.js

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

CONTRIBUTING.md

docs: add per-package READMEs and polish root docs for OSS launch

2026-03-24 04:53:00 +00:00

Dockerfile.test

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

DOCS_GUIDELINES.md

docs: improve quality based on Remotion/Stripe/Tailwind patterns

2026-03-23 23:57:01 +00:00

knip.config.ts

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

lefthook.yml

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

LICENSE

chore: initial repo setup with README, LICENSE, and contributor docs

2026-03-10 01:57:55 +00:00

package.json

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

pnpm-workspace.yaml

chore: add community docs, workspace config, and gitignore gaps

2026-03-10 04:23:12 +00:00

README.md

style: apply oxfmt formatting to markdown files

2026-03-24 04:54:24 +00:00

SECURITY.md

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

README.md

Hyperframes

Write HTML. Render video. Built for agents.

Hyperframes is an open-source video rendering framework that lets you create, preview, and render HTML-based video compositions — with first-class support for AI agents via MCP.

Why Hyperframes?

HTML-native — AI agents already speak HTML. No React required.
Frame Adapter pattern — bring your own animation runtime (GSAP, Lottie, CSS, Three.js).
Deterministic rendering — same input = identical output. Built for automated pipelines.
AI-first design — not a bolted-on afterthought.

Quick Start

npx hyperframes init my-video
cd my-video
npx hyperframes dev      # preview in browser
npx hyperframes render   # render to MP4

Requirements: Node.js >= 22, FFmpeg

How It Works

Define your video as HTML with data attributes:

<div id="stage" data-composition-id="my-video" data-start="0" data-width="1920" data-height="1080">
  <video
    id="clip-1"
    data-start="0"
    data-duration="5"
    data-track="0"
    src="intro.mp4"
    muted
    playsinline
  ></video>
  <img id="overlay" data-start="2" data-duration="3" data-track="1" src="logo.png" />
  <audio
    id="bg-music"
    data-start="0"
    data-duration="9"
    data-track="2"
    data-volume="0.5"
    src="music.wav"
  ></audio>
</div>

Preview instantly in the browser. Render to MP4 locally. Let AI agents compose videos using tools they already understand.

Packages

Package	Description
`hyperframes`	CLI — create, preview, lint, and render compositions
`@hyperframes/core`	Types, parsers, generators, linter, runtime, frame adapters
`@hyperframes/engine`	Seekable page-to-video capture engine (Puppeteer + FFmpeg)
`@hyperframes/producer`	Full rendering pipeline (capture + encode + audio mix)
`@hyperframes/studio`	Browser-based composition editor UI

Documentation

Full docs at hyperframes.heygen.com — includes guides, concepts, API reference, and package documentation.

Contributing

See CONTRIBUTING.md for guidelines on how to contribute.

License

See LICENSE for details.