docs: add Studio app pages for Mac and Linux

[miguel-heygen]

What

A new Studio app tab in the docs for the HyperFrames Studio app for Mac and Linux (the downloads on hyperframes.dev/studio). Six short pages:

1. Get the app: download and install on Mac (installer) or Linux (AppImage), first launch, sign in with HeyGen.
2. Connect your agent: Claude Code (the app installs it and opens the sign-in; the two Terminal commands if a step fails) or Codex (copy the install and sign-in commands, then Check again).
3. Make your first video: the Create your first video card (Hook, Proof, Turn, Call to action), your website or idea, Use this cut.
4. Change your video with the agent: type a change; Select, Draw and Comment on the picture; Pending video edits sent as one request; Quick edit and gap suggestions on the timeline; Get inspired; undo.
5. Export your video: quality, format and frame rate, where the file lands, export errors.
6. Updates and troubleshooting: how updates arrive and restart, HyperFrames sign-in, Claude Code signed out, usage limits, Agent access blocking a step, other chat messages, and where projects, settings and exports live on each system.

Why

Requested: "let's add docs for the hyperframe studio app too" ... "in another pr". The hyperframes.dev/studio header is getting a Docs link, and the app had no pages. The existing Studio tab documents the web editor (npx hyperframes preview), so the app gets its own tab, named so it can cover other platforms later.

Related work

None.

How

• Every button label, placeholder and message quoted on these pages was checked against the app's current source; nothing is described from memory or old copy. Features that are not on for everyone yet (for example sharing a link) are left out.
• Screenshots were taken headless from a neutral fixture project ("Spring Launch") with a fresh profile. The Home shot is cropped above the Get inspired cards.
• Images live in docs/public/images/studio-app/ (served as /public/..., like the catalog payloads), so they render on this PR's preview without a CDN upload. Happy to move them to the CDN path if a maintainer prefers.
• Platform differences (Show in Finder vs Show in folder, Cmd vs Ctrl, where settings live) are named where they appear. Windows is left out: the download page does not offer it.
• Docs only: docs/docs.json adds the tab; no code changes.

Test plan

• npx mint validate: build validation passed
• npx mint broken-links --check-redirects: no broken links (and, with one link deliberately broken on a scratch copy, it reports that link, so the check covers the new pages)
• Each page rendered with mint dev and checked at 2x in light and dark, 1440 and 390 px wide; no broken images, and no table or code line runs past the screen edge at 390 px
• Documentation updated

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
hyperframes	🟢 Ready	View Preview	Oct 5, 2026, 12:35 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[github-actions]

Edit accuracy: accurate 2040 (base branch 2040), smooth 1672 of those

The gate passes.
Smoothness is reported in the artifact, not gated. A case fails only if it fails 2 of 3 runs.

Quarantined, measured but not gated (0)

Unstable (2)

• nudge-none-pct-r0-root-z200: tracking 0.01, pressJump -, drop 0, reload 0.04, render 0.03, renderKey -, undo false, teleport true / tracking 0.01, pressJump -, drop 0, reload 0.04, render 0.03, renderKey -, undo true, teleport true / tracking 0.01, pressJump -, drop 0, reload 0.04, render 0.03, renderKey -, undo true, teleport true
• nudge-none-px-r30-nested-z100: tracking 0.01, pressJump -, drop 0, reload 0, render 0.05, renderKey -, undo false, teleport true / tracking 0.01, pressJump -, drop 0, reload 0, render 0.05, renderKey -, undo true, teleport true / tracking 0.01, pressJump -, drop 0, reload 0, render 0.05, renderKey -, undo true, teleport true

[jrusso1020]

Review at f7c7bdf2. Approving the docs content.

About the release hold: nothing on this PR enforces it. It isn't a draft, it has no label, and no check fails, so an approval here can open the gate. Some of the copy these pages quote isn't in the app as currently released. It ships with the update you're holding for:

• the installer's Checking it is really from HeyGen, HyperFrames is in Applications, Download again and took too long
• the update corner's The update is taking longer than it should, The update didn't finish, Download it instead and Download the latest version

Today's app still says "Checking HeyGen's signature" and "Installing the update is taking longer than it should." If the hold should survive this approval, marking the PR as a draft until the app ships would do it.

Checked against the app source. I grepped every bolded UI string on the six pages against the app's source. All of them are there, either in the current app or in the pending release above. Specifically:

• the agent states Ready, Not signed in, Not installed and Installed, but won't start
• Bill runs to, While Framey works, Send, Take the step by step, Bring to front, Replace with and Ask Framey
• the sign-in deadline, "within two minutes"
• Check for Updates… in the Mac menu
• Show in folder on Linux
• .hyperframes-studio for projects
• Export: MP4/WebM/MOV, 24/30/60 fps and the default of 1080p, MP4 at 30 fps. Project size replaces 1080p only when 1080p doesn't fit the project, and 4K is added when the project can take it.

Nav. The docs.json tab is valid, and every page it lists exists. /studio/index and /developers/cli resolve.

Images. Four JPGs, 1280 px wide, 64–167 KB, about 0.5 MB in total, so none are oversized.

Reuse / simplification. The existing Studio tab documents the web editor's Renders panel and its own troubleshooting, a different UI. A separate tab that links across with "Studio web editor" and "command line" is the right shape, and nothing here duplicates an existing page. Six short pages isn't over-built.

Non-blocking:

1. In export.mdx, "1080p or Project size" reads as two choices. It's one choice whose label changes: "1080p (Project size when the project isn't 16:9 at 1080p)" would match the code.
2. The link text in edit-with-the-agent.mdx says "Export and share", but the page doesn't cover sharing.
3. The other docs images are on the static CDN. /public/images works, so moving them is optional.

— Rames