Skip to content

[feat] website: add bilingual desktop download page - #413

Draft
FayeSpica wants to merge 2 commits into
ThinkFlowLab:mainfrom
FayeSpica:feat/website-download-page
Draft

FayeSpica wants to merge 2 commits into
ThinkFlowLab:mainfrom
FayeSpica:feat/website-download-page

Conversation

@FayeSpica

Copy link
Copy Markdown
Collaborator

Summary

Add a download page for OpenDirector on GitHub Pages. It recommends the Apple Silicon DMG or Windows x64 EXE when the browser can identify a compatible architecture. Users can also pick a package, install from source, or copy an installation prompt for their AI assistant. Selecting a shot on the project canvas plays We Can Still Win from that point.

How the site selects downloads

OpenDirector includes the version in each installer filename. A fixed releases/latest/download/<filename> link, like the one OpenClaw uses for its Windows installers, requires the latest release to contain that exact file.

The Pages build looks up each platform separately. A Windows-only release updates the EXE while Mac users keep the most recent DMG. Each installer links to its own release notes. Until a platform has an official package, the menu lists its desktop preview as a test build.

Maintainer setup and release

  1. In ThinkFlowLab/OpenDirector, open Settings > Pages > Build and deployment and set Source to GitHub Actions. Once this PR merges into main, the Website workflow builds, checks, and deploys the site with the built-in token.
  2. After the version-bump PR merges, push the version tag. The Desktop release workflow tests each installer and uploads it with its SHA-256 file to a shared draft. After verifying the packages and English release notes, click Publish release.
  3. Website rebuilds on main and deploys the new links after the checks pass. If you add an installer after publication, select main under Actions > Website > Run workflow.

Linked issue

Refs #368 for Pages deployment and #369 for the download page. #367 tracks updates for existing desktop installations.

Labels

  • Applied type:feat, area:install, area:i18n, and area:ci.

Test plan

  • Release selection. Run node --test website/installers.test.mjs.
  • Static build. Run bash scripts/build-website.sh _site/OpenDirector with public release data. Check separate platform versions and an API rate limit with simulated responses.
  • Browser downloads. Serve the build at http://127.0.0.1:8780/OpenDirector/. Run node website/site.test.mjs in Chromium and repeat with BROWSER=webkit.
  • Mobile layout. Open the download menu on a 390px viewport, then select the 40-second shot.
  • Workflow and translations. Run actionlint .github/workflows/website.yml and npm run check:i18n.

Test result

  • Release selection. All five tests passed, including pagination, version ordering, missing packages, and API errors.
  • Static build. The live API returned both test installers. With simulated releases, the HTML linked macOS to v0.2.9 and Windows to v0.10.0. A rate limit stopped the build and left the previous HTML intact.
  • Browser downloads. Chromium and WebKit passed with JavaScript disabled for the static menu. With JavaScript enabled, both passed the platform recommendation, Intel Mac fallback, bilingual label, release note, and missing film checks.
  • Mobile layout. The menu fit the 390px WebKit viewport, and playback started at the selected shot. The browser made no GitHub Releases API requests.
  • Workflow and translations. Actionlint passed. The bilingual check reported zero problems.

The first public Pages deployment and a download check against an official desktop release are still pending.

Evidence that it works

Both screenshots show the download menu on the same Apple Silicon Mac.

中文

中文下载菜单,显示 macOS 和 Windows 测试版安装包

English

English download menu showing the macOS and Windows test installers

Provider verification

  • The preview plays a prerecorded film and makes no model provider calls.

Bilingual UI

  • The download menu, shot labels, and installation instructions follow the browser language. Users can switch between zh-CN and en-US on the page.

Signed-off-by: Weiming Liao <liaowm5@gmail.com>
@FayeSpica FayeSpica added type:feat New capability or behaviour area:install Install, startup and environment support area:i18n Localisation and bilingual UI area:ci Continuous integration and checks labels Nov 20, 2026
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ci Continuous integration and checks area:i18n Localisation and bilingual UI area:install Install, startup and environment support type:feat New capability or behaviour

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant