Skip to content

Mobile PWA

Any phone browser pointed at your Orbit tunnel URL, with a bottom tab bar: Projects · Pipeline · Apollo · CLI · Captures. The full mobile interface, served over the Cloudflare Tunnel. From a phone you can browse all projects and drill into status, queue, completions, docs, git, and builds; watch and approve or cancel queued prompts or queue new ones via a Ship sheet; chat with Apollo with streaming replies, history, voice input (Whisper when an OpenAI key is available, Web Speech fallback) and spoken replies (ElevenLabs TTS); run shell commands or attach to a live agent PTY through a live xterm.js terminal; view git branch and commits and pull/push; trigger iOS and Android builds via a Ship modal; and manage server URL, token, model tier, and theme in a Settings sheet. Install as a PWA from the Install banner. Authenticate with the vault shared secret (the same token as desktop remote access).

Pipeline live output: tapping a running Pipeline entry opens a full-screen slide-up live-output view that consumes the existing /events/stream broadcasts through the mobile SSE hook — the rolling last ~8KB of agent output, a Live/Finished indicator, auto-follow that pauses on scroll-up, a Jump to bottom control, and a disabled CLI input bar for display-only context.

Settings & install: the Settings sheet groups Account, Defaults, and Device sections for copying the server URL, revealing and copying the token, selecting display-only model tier and theme, toggling the offline action queue, restarting the server, and signing out. A dismissible install banner appears on the Pipeline tab only when the browser exposes a PWA install path — the native prompt on Android/Chrome, Share → Add to Home Screen guidance on iOS.

Deep dive: context/design-references/design_handoff_mobile_pwa/.

The phone browser (PWA) and Settings → Mobile Setup (QR plus upload token). A phone-first layout (Pipeline, Projects, Captures, CLI, Apollo) and a standalone Capacitor app whose Pipeline drives the live cross-project queue over SSE with offline action queueing; approve, cancel, and retry from the phone.

The mobile Chat tab and the mobile Apollo mic. A per-message credit estimate-to-actual display (hidden for BYOK) with a low-balance warning, plus full push-to-hold Apollo voice tuned for touch and per-device audio formats.