Skip to content

feat(cli): offer the HyperFrames app download on Windows - #6442

Merged
miguel-heygen merged 1 commit into
mainfrom
feat/cli-windows-app-download
Oct 26, 2026
Merged

miguel-heygen merged 1 commit into
mainfrom
feat/cli-windows-app-download

Conversation

@miguel-heygen

@miguel-heygen miguel-heygen commented Oct 26, 2026 •

Copy link
Copy Markdown
Collaborator

What

On Windows, the CLI and Studio now offer the HyperFrames app download (/studio/download?os=windows) the same way they do on macOS and Linux:

  • hyperframes render and hyperframes preview print the download line.
  • hyperframes open points a Windows machine without the app to the download.
  • The Studio button shows "Install the desktop app", and its guide reads "Download for Windows".

Machines where the app is installed behave as before.

No visible change

On macOS and Linux nothing changes. The Windows wording appears only on a Windows machine, where there was no button and no download line before.

Before

On Windows, Studio's header had no desktop-app button (the preview server answered that no build existed). Capture below.

After

The button "Install the desktop app" shows, and its guide reads "Download HyperFrames for Windows". The Windows answer is a mocked /api/open-in-desktop response, the one the server tests assert for a Windows machine.

Why

The signed Windows app is launching, and these surfaces hid Windows because no build existed.

Related work

The download page itself accepting os=windows ships separately; this change points to it.

How

  • DOWNLOADS gains win32. Every surface (download line, open, the Studio route) reads that one table, so nothing else needed a Windows special case.
  • platformName in the guide card names Windows instead of "your computer".
  • Tests that asserted "no build for this machine (Windows)" now cover FreeBSD for the no-build path, and new tests cover the Windows download and its guide step.

Test plan

  • Unit tests added/updated: 37 CLI and 21 Studio tests pass; the new Windows test fails on today's main
  • Manual testing performed (no Windows machine; paths covered by unit tests)
  • Documentation updated (not applicable)
  • Comments follow CONTRIBUTING.md

before

after-button

after-guide

The CLI and Studio now point Windows to the app download.

Studio names the Windows download in its install steps.

@heygengenesis heygengenesis Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: REQUEST CHANGES · 1 blocker · 1 important · 1 nit · head b76b5293

The code is fine: one DOWNLOADS entry feeds every surface, and the 37 CLI and 21 Studio tests pass locally.

  • blocker: the required Studio and player captures check fails. ## No visible change is only allowed when the diff has no .tsx file, and this one has DesktopGuideCard.tsx. On Windows the change is visible anyway: there is a new button and a new "Download for Windows" step. Add ## Before / ## After sections with captures (a Windows-platform Studio mock is enough). This needs a body edit, not code.
  • important (merge order): https://www.hyperframes.dev/studio/download?os=windows currently returns 307 → /studio#studio-start (same as ?os=bogus; ?os=linux serves the AppImage). Until the page change ships, a Windows "Download for Windows" press lands on the landing page with no download. Merging after that change avoids it.
  • nit: "Machines where the app is installed behave as before" is not true for the CLI. HANDOFF_READY is darwin-only, so desktopHint now prints the download line after every render and preview on a Windows machine that already has the app (desktopApp.ts:245-248; before, it printed nothing). Linux already works this way, so this may be intended, but the body should say so.

— Claude

@miguel-heygen
miguel-heygen merged commit e34f9f0 into main Oct 26, 2026
64 of 65 checks passed
@miguel-heygen
miguel-heygen deleted the feat/cli-windows-app-download branch October 26, 2026 16:40
@github-actions

Copy link
Copy Markdown
Contributor

Edit accuracy: accurate 271 (base branch 271), smooth 158 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 (1)

  • seqplainkeys-none-center-r0-root-z100: tracking 0.06, pressJump 0, drop 0, reload 0, render 0.03, renderKey -, undo false, teleport true / tracking 0.06, pressJump 0, drop 0, reload 0, render 0.03, renderKey -, undo true, teleport true / tracking 0.06, pressJump 0, drop 0, reload 0, render 0.03, renderKey -, undo true, teleport true

SanHsien added a commit to SanHsien/hyperframes that referenced this pull request Oct 26, 2026
Merge 20 more upstream commits (acd0bc3..ad4d3fa, v0.8.205: heygen-com#6403,
heygen-com#6363, heygen-com#6209, heygen-com#6395, heygen-com#6424, heygen-com#6426, heygen-com#6442, heygen-com#6430, heygen-com#6402, heygen-com#6435, heygen-com#6439,
heygen-com#6449, heygen-com#5436, heygen-com#6455 and docs). No conflicts. Record the 11 open PRs
heygen-com#6440-heygen-com#6458 and issue heygen-com#6443 in docs/DECISIONS.md (none adopted), re-check
the earlier open PRs, and advance the commit watermark to ad4d3fa, the
PR watermark to heygen-com#6458 and the issue watermark to heygen-com#6443.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant