Clients · spike

Download Orb

Native shells for internet pub/sub. This page is where builds land as they get polished. Contract: living contract docs/client-spec.md v0.1.0 (in the zip as CLIENT-SPEC.md).

Spike host download.dev.orbnet.app — not production. Unsigned macOS source only; no store listings yet.

Platforms

macOS

Menu bar extra · Tauri 2 · v0.1.0

Source zip + compile on a Mac. No prebuilt .app / notarization yet (Q24).

Build from source

Windows

Tray · coming soon

Same client spec. No binary or source drop on this host yet.

Linux

StatusNotifierItem · coming soon

Notifications still required if the tray is hidden (GNOME).

iOS

coming soon

Personal Apple account later. Not a spike blocker.

Android

coming soon

FCM when there is an app. No UnifiedPush in v1.

CLI

coming soon

Until then: curl + WebSocket against api.dev / gw.dev.

macOS tray — build from source

You need a Mac (this zip will not produce a menu bar extra on Linux/Windows). The app is a menu bar extra: no Dock icon by default.

1. Download

orb-macos-0.1.0-src.zip SHA-256: 4f9b64dcd87a7fe9a04dd54768e2d88d505d98ced8f0ea42e9516f998c9bc335

Also: SHA256SUMS

2. Prerequisites

npm install only gets the Tauri CLI. You still need Rust/cargo on PATH. failed to run command cargo metadata … No such file or directory means this shell cannot find cargo — not a broken zip.

xcode-select --install
# Node 18+ (Tauri CLI only; UI is static HTML)
# Rust stable (rustc ≥ 1.77.2) — required
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"    # or open a new Terminal tab
which cargo && cargo --version

3. Unpack and build

unzip orb-macos-0.1.0-src.zip -d orb-macos
cd orb-macos
cp .env.example .env   # optional; do not commit tokens
npm install
npm run tauri dev      # menu bar extra, unsigned

Release .app (still unsigned):

npm run tauri build
# dist: src-tauri/target/release/bundle/macos/Orb.app

First launch: System Settings → Privacy & Security → Open Anyway. Notarization is out of scope.

4. Point it at the spike

Preferences (or .env):

Field	Spike value
`http_base`	`https://api.dev.orbnet.app`
`ws_base`	`wss://gw.dev.orbnet.app`
`topic_id`	`t_…`
`token`	`orb_pk_live_…` or `orb_sess_…`

Token goes in Keychain when possible, else ~/Library/Application Support/app.orbnet.orb/config.json mode 0600. Do not commit .env.

What’s in the zip

ui/ — inbox + preferences webview
src-tauri/ — Rust HTTP, WebSocket, tray, notifications
CLIENT-SPEC.md — copy of the living client contract
No node_modules, no target/, no secrets