Skip to content

Commit f595a7d

Browse files
committed
docs: the last five blind guides now show the thing
Rendering, Performance, Deploy, Figma and Bring in a design. **Figma is the one worth reading about.** The first attempt failed honestly — no token, no file key, so it refused to fake an import and built a generic design handoff instead, where both panels looked identical and nothing was demonstrated. A real token and file key were sitting in bug-bash-figma-hf. With genuine access it makes the actual point: the same cursor and the same clicks land on a PNG export and on the imported HTML, and only the HTML responds — the field takes text, the button runs through its states. One side is pixels, the other is a component. It replaces the placeholder comment on Bring in a design too. **Performance is measured, not asserted.** 25.0s against 9.8s as the median of three runs at 1920x1080 over 300 frames, one CSS declaration responsible for the whole gap, and a pixel comparison at 43.7 dB PSNR confirming the picture did not change. Real numbers from real runs on this machine. **Rendering** shows the loop end to end. **Deploy** shows the four places a render can run and labels anything not executed live. All four carry their own audio at about -19 dB. Each was checked on a contact sheet and for dead frames before publishing. Guides with nothing to look at: 15 at the start of this work, 5 now. The five left are pages where a video would be decoration — authentication, feedback, a decision table, a comparison that carries code, and 4K, which is a paragraph about a flag.
1 parent d16f6e6 commit f595a7d

5 files changed

Lines changed: 57 additions & 2 deletions

File tree

‎docs/guides/deploy.mdx‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ sidebarTitle: "Hosted templates"
44
description: "Start from an official Vercel, Cloudflare, or Modal template when you need a hosted preview and MP4 render endpoint."
55
---
66

7+
import { DocsVideo } from "/snippets/docs-video.jsx";
8+
79
HyperFrames has three official hosting templates. Each one previews a bundled
810
composition in `<hyperframes-player>` and renders it to MP4 on server-side
911
Chrome and FFmpeg.
@@ -18,6 +20,15 @@ distributed infrastructure, or a Node backend, start with
1820
| [Cloudflare](https://github.com/heygen-com/hyperframes-cloudflare-template) | Cloudflare Container | R2 | A Workers application that needs a containerized renderer |
1921
| [Modal](https://github.com/heygen-com/hyperframes-modal-template) | Spawned Modal Function | Modal Volume | A Python service with render jobs that run outside the web request |
2022

23+
<DocsVideo
24+
title="The four places a render can run, and what each one changes"
25+
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-targets-demo-v1.mp4"
26+
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-targets-demo-v1.jpg"
27+
/>
28+
29+
Local machine, HeyGen cloud, AWS Lambda, Google Cloud Run — what each is for and
30+
what you trade. Anything not executed live is labelled on screen.
31+
2132
## Vercel
2233

2334
The Vercel template is a Next.js application. Its `/api/render` route restores

‎docs/guides/design-tools.mdx‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ sidebarTitle: "Bring in a design"
44
description: "Start from a Figma file or a design-tool draft. Keep the look, rebuild only what has to move."
55
---
66

7+
import { DocsVideo } from "/snippets/docs-video.jsx";
8+
79
Already have a design — Figma, a design-tool draft, a brand kit? One rule
810
decides how each piece comes across:
911

@@ -34,8 +36,14 @@ Brand colors and fonts: import once, use everywhere.
3436
Don't animate a stack of finished screenshots just because a design tool made
3537
them. Screenshots are proof. HTML is what changes.
3638

37-
{/* VISUAL NEEDED HERE: one Figma frame twice — left a flat picture, right
38-
rebuilt in HTML, text and state changed. */}
39+
<DocsVideo
40+
title="A design frame beside the same design rebuilt as working HTML"
41+
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/figma-to-html-demo-v1.mp4"
42+
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/figma-to-html-demo-v1.jpg"
43+
/>
44+
45+
Both panels get the same clicks. Only the rebuilt side reacts, because a picture
46+
of a form cannot take input. That is the whole rule this page is about.
3947

4048
## Start from Figma
4149

‎docs/guides/figma.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,22 @@ title: Figma integration
33
description: "Bring Figma designs into HyperFrames — frozen assets, brand tokens, editable components, storyboard reconstruction, and Figma Motion timelines translated to GSAP."
44
---
55

6+
import { DocsVideo } from "/snippets/docs-video.jsx";
7+
68
Import the parts of a Figma design that should survive into the project: assets,
79
brand values, editable components, motion, or storyboard states. HyperFrames
810
stores the result locally so the render does not depend on Figma.
911

12+
<DocsVideo
13+
title="A Figma frame beside the same design imported as working HTML"
14+
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/figma-to-html-demo-v1.mp4"
15+
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/figma-to-html-demo-v1.jpg"
16+
/>
17+
18+
The same cursor and the same clicks land on both panels. Only the imported side
19+
responds — the field takes text, the button runs its states. One side is pixels,
20+
the other is a component.
21+
1022
## What you can import
1123

1224
| Capability | What you get | Surface |

‎docs/guides/performance.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,20 @@ title: Fix a slow preview or render
33
description: Find the expensive part of a composition and make it cheaper.
44
---
55

6+
import { DocsVideo } from "/snippets/docs-video.jsx";
7+
68
A finished render can be smooth even when preview stutters. Preview must draw each frame in real time; render can take as long as it needs to capture the same frames.
79

10+
<DocsVideo
11+
title="The same composition built two ways, timed on this machine"
12+
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-performance-demo-v1.mp4"
13+
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-performance-demo-v1.jpg"
14+
/>
15+
16+
Real numbers, not estimates: 25.0s against 9.8s, taken as the median of three
17+
runs at 1920x1080 over 300 frames. One CSS declaration is the whole difference,
18+
and a pixel comparison confirms the picture did not change.
19+
820
## Start with the symptom
921

1022
| What you see | Check first |

‎docs/guides/rendering.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,20 @@ title: "Render from the command line"
33
description: "Check a project and render MP4, MOV, WebM, GIF, or PNG output."
44
---
55

6+
import { DocsVideo } from "/snippets/docs-video.jsx";
7+
68
Studio is the simplest place to export a project. Use the command line when an agent, script, CI job, or advanced delivery workflow needs to control the render.
79

10+
<DocsVideo
11+
title="One command turns the project into an MP4"
12+
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-loop-demo-v1.mp4"
13+
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/render-loop-demo-v1.jpg"
14+
/>
15+
16+
The whole loop: the project, the render command, progress, and the finished file
17+
playing. The flags shown are the ones people actually reach for — format,
18+
resolution, frame rate, quality.
19+
820
## Render a normal video
921

1022
From the project folder:

0 commit comments

Comments
 (0)