docs: desktop release (keys, privacy gate, signing, runners, hosting, publish); downloads page site/desktop/

This commit is contained in:
CRTkafa 2026-10-11 05:17:00 +08:00
parent c0bae1ee31
commit e63cb5bff7
4 changed files with 489 additions and 1 deletions

View file

@ -2,6 +2,17 @@
## Unreleased ## Unreleased
- **Desktop D5: release pipeline.** The desktop app is a separate signed download from storebound.dev/desktop/ (DMG,
Windows installer, AppImage / deb) that updates itself; the npm package stays the CLI, MCP server and skills.
`storebound desktop` opens the app (in an app folder it adds or selects that folder through
`storebound://open?path=`, after the app's own dialog) or prints the download for this system; `--download` saves
it to ~/Downloads after checking its SHA-256 and minisign signature, and never installs. One desktop version
(`desktopVersion` in package.json, checked in CI), a privacy scan of every artifact (`tools/privacy-scan.ts`),
path-free builds, `tools/desktop-release.ts` (universal macOS app + DMG, Developer ID + notarization when the
certificate exists, otherwise an ad-hoc `-unsigned` preview; self-test of the exact artifacts; signed latest.json),
a Forgejo workflow for Linux and Windows, the root-owned publish step on the server and a downloads page
(`site/desktop/`). Settings > Updates checks and installs signed updates on request. See `docs/desktop-release.md`.
- **Desktop machine interface** (`serve --stdio`): JSON-RPC session for the coming desktop app, built on the MCP core. - **Desktop machine interface** (`serve --stdio`): JSON-RPC session for the coming desktop app, built on the MCP core.
Typed methods with argument schemas, structured results, progress notifications, cancellation, `project.inspect` Typed methods with argument schemas, structured results, progress notifications, cancellation, `project.inspect`
and `portfolio.status`: apps across iOS and Android with identity, config check, release trains (current and next and `portfolio.status`: apps across iOS and Android with identity, config check, release trains (current and next

253
docs/desktop-release.md Normal file
View file

@ -0,0 +1,253 @@
# Releasing storebound desktop
How the desktop app (`apps/desktop`) is built, signed, checked and published. For what the app does, see
[desktop.md](desktop.md).
## Distribution
- **The desktop app is its own download.** A signed app from storebound.dev/desktop/:
- macOS: a DMG with a universal app (Apple silicon and Intel), macOS 11 or later;
- Windows: an NSIS installer that installs for the current user and brings the WebView2 bootstrapper;
- Linux: an AppImage and a .deb, built on Ubuntu 22.04.
- **It updates itself** with Tauri's updater: storebound.dev/desktop/latest.json, every bundle signed with the
updater key. The app checks the signature before it replaces anything and installs only after the owner clicks
Install in a native dialog (Settings > Updates).
- **It brings its own CLI.** The app bundles the storebound CLI as a sidecar, so it never depends on an npm install.
- **The npm package stays the CLI, the MCP server and the skills.** It contains no Tauri binaries.
- **Bridge: `storebound desktop`.**
- Installed: it opens the app. In an app folder it sends `storebound://open?path=<folder>`, and the app selects
that folder, or adds it after a native dialog.
- Not installed: it prints the download for this OS and CPU.
- `--download` saves the installer to ~/Downloads after checking its size, SHA-256 and minisign signature. It never
installs anything.
## One version
`desktopVersion` in the root `package.json` is the desktop app's version. The npm package's own `version` belongs
to the CLI and moves on its own.
- `bun tools/desktop-version.ts` checks the copies: `apps/desktop/package.json`, `tauri.conf.json`, `Cargo.toml`
and the app's entry in `Cargo.lock`. CI runs this check.
- `bun tools/desktop-version.ts --set 0.1.1` writes a new version into all of them.
- `src-tauri/tests/d5.rs` checks the same thing again from the Rust side.
## Keys and private files (outside every repository)
`~/.storebound-keys/` (mode 700) on the release Mac holds:
| file | what | made by |
|---|---|---|
| `updater.key` | minisign private key of the updater (no password; mode 600) | `bunx tauri signer generate -w ~/.storebound-keys/updater.key -p "" --ci` (done once, D5) |
| `updater.key.pub` | its public key; the same text is `plugins.updater.pubkey` in tauri.conf.json and `PUBLIC_KEY` in cli/lib/desktop-dist.ts | the same command |
| `forbidden-terms.txt` | names the privacy scan must never find: one per line (people, accounts, emails, machine names) | the owner |
| `notary.json` | `{"keyId", "issuerId", "keyPath"}` of an App Store Connect API key for notarytool | the owner, once a Developer ID exists |
**Back up `updater.key`** (password manager or an offline copy). If it is lost, installed apps can never update
again: they only accept bundles signed with this key, so everyone would have to reinstall by hand. Never commit
it, never copy it to a runner. The Forgejo workflow builds unsigned installers, and the Mac signs them.
## Privacy gate
`bun tools/privacy-scan.ts <files or folders>` runs on every artifact before it can ship.
- **Terms it looks for:**
- the terms file;
- this machine's account name, home folder, full name, host and computer names, and git's global identity;
- the private-name rule of tools/scrub.ts;
- any `/Users/<name>`, `/home/<name>` or `C:\Users\<name>` that is not a generic account.
- **How it reads files:** as bytes, in UTF-8 and UTF-16LE.
- **Archives it opens:** DMG (mounted read-only, never shown in Finder), .tar.gz, .deb, .zip, AppImage (unsquashfs
or 7-Zip) and NSIS (7-Zip).
- **Debug files:** .dSYM, .pdb and source maps fail the scan.
- **Exit codes:** 1 when it finds something, 2 when it cannot open an archive. A term is never printed in full.
**Path-free builds.** `tools/desktop-release.ts` builds with `--remap-path-prefix` and `-ffile-prefix-map`, which
turn home into `~`, the checkout into `/src`, the cargo and rustup homes into `/cargo` and `/rustup`, and
`CARGO_TARGET_DIR` into `/target`. On Windows it also uses `/PDBALTPATH` and `/d1trimfile`. The target folder must
be outside the home folder. Release profile: `strip = true`, LTO, `panic = "abort"`.
## macOS (on the owner's Mac)
```sh
bun tools/desktop-release.ts mac --out ~/.storebound-releases/desktop/0.1.0 # from a clean commit
```
**Runs in the owner's logged-in macOS session.** It refuses SSH and background sessions: over SSH `codesign`
cannot use the login keychain (errSecInternalComponent).
What it does, in order:
1. Checks the session, the version, a clean checkout, the updater key and that the rustup targets are installed.
2. Picks the signing identity:
- **Developer ID Application found** (`security find-identity -v -p codesigning`): hardened runtime with
`src-tauri/entitlements.plist` (JIT for the Bun sidecar), notarization and stapling. Tauri notarizes the app,
the script notarizes the DMG.
- **None found**: an ad-hoc signed build whose files end in `-unsigned`.
3. Builds the sidecars for arm64 and x64, merges them into one universal file with `lipo`, then runs
`tauri build --target universal-apple-darwin --bundles app` with the path-free environment.
4. Makes the updater bundle (`.app.tar.gz`, root-owned entries, no macOS metadata) and the DMG. The DMG is made with
`hdiutil` only (no Finder scripting, nothing comes to the front).
5. **Checks the exact artifacts:**
- `codesign --verify --deep --strict`;
- the Gatekeeper expectation (signed: `spctl` accepts it as Notarized Developer ID and `stapler validate` passes;
unsigned: ad-hoc, and `spctl` rejects it);
- the self-test, run from the mounted DMG and from the unpacked updater bundle, for both CPU types (x86_64 through
Rosetta). `storebound-desktop --self-test` starts the bundled sidecar, sends `session.hello`, prints one JSON
line and exits, before Tauri starts, so no window opens;
- the privacy scan of the app, the DMG and the updater bundle.
6. Writes minisign `.sig` files with the updater key and checks them right away against tauri.conf.json's key.
7. Writes `latest.json`, `SHA256SUMS` and `evidence-macos-<version>.json`. The evidence file (tool versions, checks,
hashes) stays local.
### Owner actions for a signed macOS build
1. **Developer ID certificate.** your Apple developer team's Account Holder creates a **Developer ID Application**
certificate: developer.apple.com > Certificates > +, with a CSR from Keychain Access on this Mac. Install it in
the login keychain. Today the keychain has Apple Distribution and Development identities only, so builds are
unsigned previews.
2. **Notarization key.** An App Store Connect API key (Users and Access > Integrations, role Developer) as
`~/.storebound-keys/notary.json` and its `.p8` file. Or set `APPLE_API_KEY`, `APPLE_API_ISSUER` and
`APPLE_API_KEY_PATH`.
3. **Rebuild.** Run the command above in Terminal on the Mac.
### Opening an unsigned preview (what the downloads page says)
macOS: copy storebound to Applications and open it. When macOS refuses, open System Settings > Privacy & Security
and choose Open Anyway (once).
## Windows and Linux (Forgejo Actions)
`.forgejo/workflows/desktop.yml` runs on a `desktop-v*` tag or by hand (workflow_dispatch; tick "windows" only when
a Windows runner exists).
- **Linux** (`runs-on: ubuntu-22.04`, a container): AppImage and .deb built with the path-free environment, then:
- self-tests of the extracted AppImage and the unpacked .deb;
- the privacy scan and SHA256SUMS;
- an artifact `storebound-desktop-linux`.
`WEBKIT_DISABLE_DMABUF_RENDERER=1`: the app sets it itself at start on Linux unless the user set it (some GPU / VM
setups leave the window blank with DMABUF), and the workflow sets it too.
- **Windows** (`runs-on: windows`): an NSIS installer (`installMode: currentUser`, WebView2 `embedBootstrapper`,
unsigned), then:
- a silent per-user install (`/S`), the self-test of the installed exe, a silent uninstall;
- the privacy scan;
- an artifact `storebound-desktop-windows`.
Then on the Mac:
```sh
bun tools/desktop-release.ts add --out ~/.storebound-releases/desktop/0.1.0 \
storebound_0.1.0_amd64.AppImage storebound_0.1.0_amd64.deb storebound_0.1.0_x64-setup.exe
```
It scans and signs each file, renames the unsigned Windows installer to `-unsigned`, and updates latest.json
(`windows-x86_64`, `linux-x86_64`) and SHA256SUMS. For the scan, install `squashfs` and `sevenzip` from Homebrew.
### Runner setup (not done yet)
Forgejo runs in Docker on the VDS; Actions is off (`[actions] ENABLED = false` in its app.ini).
1. **Enable Actions in Forgejo.** In `app.ini`, set `[actions] ENABLED = true` and
`DEFAULT_ACTIONS_URL = https://data.forgejo.org`. Restart the forgejo container, then enable Actions in the
repository settings.
2. **Linux runner on the VDS, in Docker.**
- Get a registration token: Site administration > Actions > Runners > Create new runner.
- Register and run:
```sh
mkdir -p /srv/forgejo-runner && cd /srv/forgejo-runner
docker run --rm -v $PWD:/data code.forgejo.org/forgejo/runner:6 forgejo-runner generate-config > config.yml
# in config.yml: runner.labels: ["ubuntu-22.04:docker://ghcr.io/catthehacker/ubuntu:act-22.04"],
# runner.capacity: 1, container.network: bridge, no privileged mode, no docker socket in jobs
docker run --rm -it -v $PWD:/data code.forgejo.org/forgejo/runner:6 forgejo-runner register \
--no-interactive --instance https://git.crt.fyi --token <token> --name vds-linux --labels ubuntu-22.04
```
- Run it as a service: the `forgejo-runner daemon` container with `/data` and the Docker socket, restart
unless-stopped.
- Jobs run in throwaway containers. The runner never sees a signing key.
3. **Windows runner (later).** The owner has no Windows machine yet. On one (Windows 10/11 x64):
- install Rust (MSVC, with the Visual Studio Build Tools), Bun and 7-Zip;
- run `forgejo-runner register --labels windows:host`, then `forgejo-runner daemon` as a service.
Until then, Windows waits; the workflow's Windows job only runs when "windows" is ticked.
4. **Windows code signing (later).** Buy a code-signing certificate, then sign the installer before `add` and pass
`--code-signed`.
## Hosting on storebound.dev
| URL | served from | how it gets there |
|---|---|---|
| /desktop/ (downloads page) | /var/www/storebound.dev/desktop/index.html | `site/desktop/index.html`, with the site (Jenkins + /usr/local/sbin/storebound-publish) |
| /desktop/latest.json, /desktop/beta/latest.json | /var/www/storebound-desktop/ | storebound-desktop-publish |
| /desktop/dl/<version>/<files> | /var/www/storebound-desktop/dl/ | storebound-desktop-publish |
**Why the binaries live outside the site's document root.** The site's publish script rsyncs `site/` with
`--delete-after`, so anything not in git would vanish on the next site deploy. Binaries are never committed.
Apache maps the three paths with `Include /etc/apache2/storebound-desktop.conf` in the :443 vhost
(`tools/vds/apache-storebound-desktop.conf`):
- latest.json is sent `no-cache`;
- version folders are sent `immutable`;
- no directory listings.
**`/usr/local/sbin/storebound-desktop-publish <version> [stable|beta]`** (`tools/vds/storebound-desktop-publish`,
root:root 755) takes `/var/lib/storebound-desktop/incoming/<version>/` (root only, mode 700) and checks it:
- only plain files with plain names;
- SHA256SUMS matches;
- latest.json is that version, and every URL in it names an uploaded file under /desktop/dl/<version>/.
Then it publishes:
- a new version folder appears at once (temp folder, then rename);
- a later `add` to the same version only adds files, and a published file is never replaced by other bytes;
- latest.json goes in last (temp file, then rename), so apps see a version only when all its files are there.
It runs nothing from the upload.
**No sudoers entry is needed today.** The owner's Mac uploads and runs the script as root over SSH. If a CI job
should publish one day, give its user exactly this script, as the existing Jenkins entries do:
`<user> ALL=(root) NOPASSWD: /usr/local/sbin/storebound-desktop-publish`.
Both files are installed on the VDS (D5). The Apache vhost was backed up to `/root/storebound.dev.conf.bak-*` first.
To reinstall after a change:
```sh
scp tools/vds/storebound-desktop-publish root@<server>:/usr/local/sbin/storebound-desktop-publish
scp tools/vds/apache-storebound-desktop.conf root@<server>:/etc/apache2/storebound-desktop.conf
ssh root@<server> 'chmod 755 /usr/local/sbin/storebound-desktop-publish && apache2ctl configtest && systemctl reload apache2'
```
## Publish
Publishing is the owner's call. Every installed app on the channel offers the update as soon as latest.json is
live.
```sh
export STOREBOUND_PUBLISH_HOST=root@<server> # the VDS (not the Cloudflare name)
bun tools/desktop-release.ts verify --out ~/.storebound-releases/desktop/0.1.0
bun tools/desktop-release.ts publish --out ~/.storebound-releases/desktop/0.1.0 # dry run: the plan
bun tools/desktop-release.ts publish --out ~/.storebound-releases/desktop/0.1.0 --yes # upload + publish
```
1. **Checks again:** sums, signatures against tauri.conf.json's key, latest.json and the privacy scan.
2. **Uploads:** rsync into the incoming folder (evidence stays local).
3. **Publishes:** runs the publish script.
4. **Confirms:** reads the live latest.json back.
`--channel beta` publishes to /desktop/beta/latest.json, which apps on the Beta channel read.
**Rollback.** Tauri updates only to a higher version, so a bad release is replaced by a fixed higher version. Its
files stay where they are, because links and checksums must not change.
## Going public: checklist
1. Developer ID Application certificate and notary key on the Mac, then a signed, notarized macOS build.
Check: `spctl` accepted, `stapler validate` OK, self-test from the DMG.
2. Forgejo Actions enabled, the Linux runner registered, a `desktop-v0.1.0` tag built, `add` of the AppImage and
deb.
3. Windows: a runner, or ship macOS + Linux first. The page and latest.json list only what exists.
4. `publish --yes` to stable. Then open storebound.dev/desktop/ on each OS and run `storebound desktop --download`.
5. An updater round trip: publish 0.1.1 to beta, switch a 0.1.0 install to Beta, Check for updates, Install.
6. Link /desktop/ from the main page, and update README and CHANGELOG.

View file

@ -129,7 +129,7 @@ host state file (`overrides_set`, every key checked in `workspace.rs`).
- Dependencies and the CLI sidecar. - Dependencies and the CLI sidecar.
- Privacy, with a button that reveals the data folder. - Privacy, with a button that reveals the data folder.
- Shortcuts. - Shortcuts.
- Update channel (placeholder until the updater ships). - Updates: channel (stable / beta), check and install (D5).
- Reset: native confirmation, then the keychain entries and every saved state are removed. - Reset: native confirmation, then the keychain entries and every saved state are removed.
### Writes in the window ### Writes in the window
@ -189,6 +189,20 @@ Download sources (one click on the Dependencies screen or in the first-run guide
- **Progress and cancel** go through the same progress events as sidecar jobs; a cancelled download removes its - **Progress and cancel** go through the same progress events as sidecar jobs; a cancelled download removes its
temporary file. temporary file.
## Release, updates and the terminal bridge (D5)
- Releases: [desktop-release.md](desktop-release.md) (version authority, privacy gate, macOS signing and
notarization, Forgejo builds for Linux and Windows, storebound.dev hosting, publish).
- **Updates**: Settings > Updates checks storebound.dev (stable `/desktop/latest.json` or beta
`/desktop/beta/latest.json`) only when asked; Install shows a native dialog, then the updater downloads the bundle,
checks its minisign signature against `plugins.updater.pubkey` and restarts (`update_check`, `update_install`).
- **`storebound://open?path=<absolute folder>`** (sent by `storebound desktop` in an app folder): the host accepts
one plain absolute path (`policy::deep_link_open_path`), selects that app folder when it is in the list, otherwise
asks in a native dialog and adds it (`deep-link-folder` event). A folder without a storebound config gets a message,
nothing else.
- **`storebound-desktop --self-test`**: starts the bundled sidecar, checks the `session.hello` handshake, prints one
JSON line and exits, before Tauri starts (no window). The release runs it on the exact artifacts.
## Develop ## Develop
```sh ```sh

210
site/desktop/index.html Normal file
View file

@ -0,0 +1,210 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>storebound desktop · download</title>
<meta name="description" content="storebound desktop: every app and game on Google Play and the App Store in one window, driving the same storebound CLI. Downloads for macOS, Windows and Linux with checksums and signatures.">
<link rel="canonical" href="https://storebound.dev/desktop/">
<meta name="color-scheme" content="light dark">
<meta name="theme-color" content="#f8fafc" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#0b1120" media="(prefers-color-scheme: dark)">
<link rel="icon" href="../favicon.svg" type="image/svg+xml">
<meta property="og:type" content="website">
<meta property="og:site_name" content="storebound">
<meta property="og:url" content="https://storebound.dev/desktop/">
<meta property="og:title" content="storebound desktop · download">
<meta property="og:description" content="Every app and game on both stores in one window. macOS, Windows, Linux.">
<meta property="og:image" content="https://storebound.dev/og.png">
<link rel="stylesheet" href="../style.css">
<script>document.documentElement.classList.add('js')</script>
<style>
/* page-only parts; colours and type come from ../style.css tokens (fallbacks keep the page readable alone) */
.dl-hero { padding: 56px 0 40px; }
.dl-hero h1 { font-size: clamp(30px, 5vw, 46px); font-weight: 760; }
.dl-main { display: flex; flex-wrap: wrap; align-items: center; gap: 12px 16px; margin-top: 28px; }
.dl-main .meta { color: var(--muted, #64748b); font-size: 14.5px; }
.dl-notice { margin-top: 22px; max-width: 46em; padding: 14px 16px; border-radius: 12px; border: 1px solid var(--ui-ink, #92400e); background: var(--ui-bg, #fef3c7); color: var(--ui-ink, #92400e); font-size: 15px; }
.dl-notice b { font-weight: 700; }
.dl-notice ol { margin: 8px 0 0; padding-left: 20px; }
.dl-table { width: 100%; border-collapse: collapse; margin-top: 24px; font-size: 15px; }
.dl-table th, .dl-table td { text-align: left; padding: 12px 10px; border-bottom: 1px solid var(--line, #e2e8f0); vertical-align: top; }
.dl-table th { font: 600 12.5px var(--mono, monospace); text-transform: uppercase; letter-spacing: .08em; color: var(--muted, #64748b); }
.dl-table tr.here td { background: var(--accent-soft, #eef2ff); }
.dl-table .sha { font: 12.5px/1.5 var(--mono, monospace); color: var(--ink-2, #334155); overflow-wrap: anywhere; display: block; max-width: 34em; }
.dl-table .fname { font-weight: 600; overflow-wrap: anywhere; }
.dl-table .small { font-size: 13.5px; color: var(--muted, #64748b); }
.dl-steps { margin: 16px 0 0; padding-left: 20px; color: var(--ink-2, #334155); max-width: 50em; }
.dl-steps li { margin: 6px 0; }
.dl-key { display: block; margin-top: 8px; font: 13px/1.6 var(--mono, monospace); overflow-wrap: anywhere; }
@media (max-width: 720px) {
.dl-table thead { display: none; }
.dl-table, .dl-table tbody, .dl-table tr, .dl-table td { display: block; width: 100%; }
.dl-table tr { border-bottom: 1px solid var(--line, #e2e8f0); padding: 8px 0; }
.dl-table td { border: 0; padding: 4px 0; }
}
</style>
</head>
<body>
<a class="skip" href="#main">Skip to content</a>
<header class="top">
<div class="wrap top-in">
<a class="brand" href="../" aria-label="storebound home">
<svg class="mark" viewBox="0 0 32 32" aria-hidden="true"><rect width="32" height="32" rx="8" fill="currentColor"/><path d="M16 7v12M10.5 12.5 16 7l5.5 5.5" fill="none" stroke="var(--mark-ink)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><path d="M8 18v5.5h16V18" fill="none" stroke="var(--mark-ink)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/></svg>
<span>storebound</span>
</a>
<nav aria-label="Primary">
<a href="../">Home</a>
<a href="#all">All downloads</a>
<a href="#verify">Verify</a>
<a class="nav-git" href="https://git.crt.fyi/CRT/storebound" target="_blank" rel="noopener">git<span class="ext" aria-hidden="true">↗</span><span class="sr-only"> (opens in a new tab)</span></a>
</nav>
</div>
</header>
<main id="main">
<section class="dl-hero">
<div class="wrap">
<p class="kicker">Desktop app · preview</p>
<h1>storebound desktop</h1>
<p class="sub">Every app and game you ship, on Google Play and the App Store, in one window: releases on both stores, catalog parity, listings, crash health, reviews and TestFlight. It drives the same open source storebound CLI, keeps store keys in the system keychain, shows a dry run before every change, and never presses Submit.</p>
<div class="dl-main" id="primary" aria-live="polite">
<p class="meta" id="status">Looking up the latest release…</p>
</div>
<noscript><p class="note">The download list needs JavaScript. Without it: <a href="latest.json">latest.json</a> lists every file with its SHA-256.</p></noscript>
<div id="notice"></div>
<p class="note">Already use the CLI? <code>storebound desktop</code> opens the app in your app folder, or prints the download for your system; <code>storebound desktop --download</code> saves the installer to ~/Downloads after checking its signature (it never installs anything).</p>
</div>
</section>
<section class="sec alt" id="all">
<div class="wrap">
<p class="kicker">All downloads</p>
<h2>Every system, with checksums</h2>
<p class="sub" id="all-sub">The app updates itself from this site: each update is signed, and the app checks the signature before it replaces anything. It asks before installing.</p>
<table class="dl-table" id="table" hidden>
<thead><tr><th scope="col">System</th><th scope="col">File</th><th scope="col">SHA-256</th></tr></thead>
<tbody id="rows"></tbody>
</table>
</div>
</section>
<section class="sec" id="verify">
<div class="wrap">
<p class="kicker">Verify</p>
<h2>Check a download yourself</h2>
<ol class="dl-steps">
<li>Checksum: <code>shasum -a 256 &lt;file&gt;</code> (macOS, Linux) or <code>Get-FileHash &lt;file&gt;</code> (Windows) must print the SHA-256 above.</li>
<li>Signature: every file has a <code>.sig</code> next to it (the app's update key, minisign). With <a href="https://jedisct1.github.io/minisign/" target="_blank" rel="noopener">minisign</a>: <code>base64 -d &lt;file&gt;.sig &gt; f.minisig &amp;&amp; minisign -Vm &lt;file&gt; -x f.minisig -P &lt;key&gt;</code>, with the public key
<code class="dl-key">RWQqOO/ZeIr3RBmolt/fx108m89QNEUndRTFrucjx0CBMoeFb7/xhrvW</code></li>
<li>Or let the CLI do both: <code>storebound desktop --download</code>.</li>
</ol>
<p class="note">The npm package <code>storebound</code> stays the CLI, MCP server and agent skills; it does not contain this app. The app brings its own copy of the CLI.</p>
</div>
</section>
</main>
<footer class="foot">
<div class="wrap foot-in">
<div>
<a class="brand" href="../" aria-label="storebound home">
<svg class="mark" viewBox="0 0 32 32" aria-hidden="true"><rect width="32" height="32" rx="8" fill="currentColor"/><path d="M16 7v12M10.5 12.5 16 7l5.5 5.5" fill="none" stroke="var(--mark-ink)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><path d="M8 18v5.5h16V18" fill="none" stroke="var(--mark-ink)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/></svg>
<span>storebound</span>
</a>
<p class="fine">MIT · made by CRTkafa · not affiliated with Google or Apple.</p>
</div>
<nav aria-label="Footer">
<a href="https://git.crt.fyi/CRT/storebound/src/branch/main/docs/desktop.md" target="_blank" rel="noopener">desktop docs<span class="ext" aria-hidden="true">↗</span><span class="sr-only"> (opens in a new tab)</span></a>
<a href="https://git.crt.fyi/CRT/storebound/src/branch/main/CHANGELOG.md" target="_blank" rel="noopener">CHANGELOG<span class="ext" aria-hidden="true">↗</span><span class="sr-only"> (opens in a new tab)</span></a>
<a href="https://git.crt.fyi/CRT/storebound/src/branch/main/SECURITY.md" target="_blank" rel="noopener">SECURITY<span class="ext" aria-hidden="true">↗</span><span class="sr-only"> (opens in a new tab)</span></a>
</nav>
</div>
</footer>
<script>
// Reads latest.json (same origin, published with the binaries) and fills the page. Everything from it is set as
// text, never as HTML; only storebound.dev/desktop/dl/ links are shown.
(function () {
var LABEL = {
'macos-universal-dmg': ['macOS 11 or later', 'Apple silicon and Intel, .dmg'],
'windows-x86_64-nsis': ['Windows 10 / 11', 'x64 installer, installs for your user only'],
'linux-x86_64-appimage': ['Linux', 'x64 AppImage (Ubuntu 22.04+, Debian 12+)'],
'linux-x86_64-deb': ['Linux (Debian, Ubuntu)', 'x64 .deb package']
};
var ORDER = ['macos-universal-dmg', 'windows-x86_64-nsis', 'linux-x86_64-appimage', 'linux-x86_64-deb'];
function el(tag, attrs, text) { var e = document.createElement(tag); for (var k in attrs || {}) e.setAttribute(k, attrs[k]); if (text != null) e.textContent = text; return e; }
function mb(n) { return (n / 1e6).toFixed(1) + ' MB'; }
function ours(u) { try { var x = new URL(u, location.href); return x.protocol === 'https:' && x.host === 'storebound.dev' && x.pathname.indexOf('/desktop/dl/') === 0; } catch (e) { return false; } }
function system() {
var p = ((navigator.userAgentData && navigator.userAgentData.platform) || navigator.platform || '') + ' ' + navigator.userAgent;
if (/android|iphone|ipad|ipod/i.test(p)) return 'mobile';
if (/mac/i.test(p)) return 'macos-universal-dmg';
if (/win/i.test(p)) return 'windows-x86_64-nsis';
if (/linux|x11/i.test(p)) return 'linux-x86_64-appimage';
return null;
}
var status = document.getElementById('status');
var primary = document.getElementById('primary');
var notice = document.getElementById('notice');
fetch('latest.json', { cache: 'no-cache' }).then(function (r) {
if (r.status === 404) throw new Error('none');
if (!r.ok) throw new Error('HTTP ' + r.status);
return r.json();
}).then(function (m) {
var d = m.downloads || {};
var keys = ORDER.filter(function (k) { return d[k] && ours(d[k].url); });
if (!keys.length) throw new Error('none');
var here = system();
var pick = d[here] && keys.indexOf(here) >= 0 ? here : null;
primary.textContent = '';
if (pick) {
var a = el('a', { 'class': 'btn btn-primary', href: d[pick].url }, 'Download for ' + LABEL[pick][0]);
primary.appendChild(a);
} else {
primary.appendChild(el('a', { 'class': 'btn btn-primary', href: '#all' }, 'Choose your system'));
}
var meta = 'Version ' + m.version + (m.pub_date ? ' · ' + m.pub_date.slice(0, 10) : '') + (pick ? ' · ' + mb(d[pick].size) : '') + (here === 'mobile' ? ' · the desktop app runs on macOS, Windows and Linux' : '');
primary.appendChild(el('p', { 'class': 'meta' }, meta));
var unsigned = keys.filter(function (k) { return !d[k].codeSigned && (k === 'macos-universal-dmg' || k === 'windows-x86_64-nsis'); });
if (unsigned.length) {
var n = el('div', { 'class': 'dl-notice', role: 'note' });
n.appendChild(el('b', null, 'Unsigned preview. '));
n.appendChild(document.createTextNode('This early build is not yet signed by Apple or Microsoft, so your system asks once before opening it. Check the SHA-256 below first.'));
var ol = el('ol');
if (unsigned.indexOf('macos-universal-dmg') >= 0) ol.appendChild(el('li', null, 'macOS: drag storebound to Applications and open it; when macOS refuses, open System Settings > Privacy & Security and choose Open Anyway (once).'));
if (unsigned.indexOf('windows-x86_64-nsis') >= 0) ol.appendChild(el('li', null, 'Windows: when SmartScreen shows "Windows protected your PC", choose More info > Run anyway.'));
n.appendChild(ol);
notice.appendChild(n);
}
var rows = document.getElementById('rows');
keys.forEach(function (k) {
var x = d[k];
var tr = el('tr', k === pick ? { 'class': 'here' } : {});
var sys = el('td');
sys.appendChild(el('b', null, LABEL[k][0]));
sys.appendChild(el('div', { 'class': 'small' }, LABEL[k][1] + ((k === 'macos-universal-dmg' || k === 'windows-x86_64-nsis') && !x.codeSigned ? ' · unsigned preview' : '')));
var file = el('td');
file.appendChild(el('a', { 'class': 'fname', href: x.url }, x.file));
var sub = el('div', { 'class': 'small' }, mb(x.size) + ' · ');
sub.appendChild(el('a', { href: x.url + '.sig' }, 'signature'));
file.appendChild(sub);
var sha = el('td');
sha.appendChild(el('code', { 'class': 'sha' }, x.sha256));
tr.appendChild(sys); tr.appendChild(file); tr.appendChild(sha);
rows.appendChild(tr);
});
document.getElementById('table').hidden = false;
}).catch(function (e) {
var none = e && e.message === 'none';
status.textContent = none
? 'The first desktop release is not published yet. Until then the storebound CLI does everything the app will show.'
: 'Could not read the release list (' + (e && e.message) + '). latest.json has every file and its SHA-256.';
if (none) primary.appendChild(el('a', { 'class': 'btn btn-ghost', href: '../#start' }, 'Get the CLI'));
else primary.appendChild(el('a', { 'class': 'btn btn-ghost', href: 'latest.json' }, 'latest.json'));
});
})();
</script>
</body>
</html>