Files

T

Bohdan Triapitsyn 86ef96302d feat(mobile): mobile app navigation rework and beta-feedback closeout (#2561 )

Navigation model rebuilt around two full-width drawers and a minimal
header (sessions / title-switcher / usage ring / workspace):

- Left sessions drawer: cross-project tree with live status indicators,
  swipe actions on sessions (rename/archive/delete) and on group headers
  (project edit / two-step close, worktree delete), reorder-only edit
  mode with collapsible project cards and draggable worktrees, app-level
  footer (connected instance, settings, pending web update).
- Right workspace drawer: Changes / Files / Terminal / Notes / MCP as
  pill tabs (inactive tabs icon-only); panes stay mounted once visited.
  The full desktop file editor serves the Files tab; read/skill tool taps
  in chat open the file there at the requested line.
- Header session switcher on title tap: 10 cross-project recents with
  live busy/attention indicators and project · branch metadata; the
  usage ring opens a metadata overlay with an explicit loading state.
- The overflow menu is gone on phones (its destinations moved into the
  drawers); iPad keeps it until its dedicated layout pass.

Correctness and continuity:

- /auth/session answers bearer-first, so a stale WebView cookie can no
  longer mask a revoked device token; cold launches classify failures
  fast and land on an explicit connect screen.
- Authoritative session snapshots raise frozen ordering baselines and
  stale live ranks — recents stay truthful after the app slept.
- Cold launches reopen the last active session per instance (persisted
  pointer, confirmed against a sessions snapshot; a user-opened draft
  clears it), with a logo hold instead of a draft flash.

Also: collapsed pill composer gains the stop control; chat tool rows
share one 36px rhythm; Task subtool rows truncate; larger bottom safe
area so the composer clears big-screen corner radii; Capacitor build
hides About/Update (store updates apply there); widgets link to the
sessions drawer with a list icon; MobileApp split into focused modules;
five mobile-surface detectors unified; translucent borders normalized to
70%; all new strings translated across the 10 locales.

iPad and foldable layouts are intentionally untouched - separate next version PR.

2026-08-01 21:16:36 +03:00

android

chore: enforce LF line endings via gitattributes

2026-07-20 19:38:02 +03:00

assets

feat: native iOS & Android mobile apps (Capacitor) (#1954 )

2026-07-01 09:55:41 +03:00

ios

feat(mobile): mobile app navigation rework and beta-feedback closeout (#2561 )

2026-08-01 21:16:36 +03:00

scripts

feat: add one-command mobile simulator dev loop

2026-07-28 23:34:06 +03:00

capacitor.config.ts

feat: pairing v2 — one-tap trusted devices over LAN and private relay (#2103 )

2026-07-10 00:12:33 +03:00

HANDOFF.md

feat: native iOS & Android mobile apps (Capacitor) (#1954 )

2026-07-01 09:55:41 +03:00

package.json

feat: add one-command mobile simulator dev loop

2026-07-28 23:34:06 +03:00

README.md

feat: add one-command mobile simulator dev loop

2026-07-28 23:34:06 +03:00

tsconfig.json

feat: native iOS & Android mobile apps (Capacitor) (#1954 )

2026-07-01 09:55:41 +03:00

README.md

OpenChamber Mobile

Capacitor shell for the dedicated OpenChamber mobile web surface.

The mobile package reuses the web build, then rewrites mobile.html to index.html in packages/mobile/dist so native iOS/Android always launch MobileApp instead of the hosted surface selector.

Runtime Model

The native app bundles the mobile UI only; it does not embed the OpenChamber web server or OpenCode server.
On first launch in Capacitor, the app shows a connection screen for an existing OpenChamber server.
Connections are saved locally in the app and can be managed from the mobile overflow menu under Instances.
The connection screen and Instances menu item are Capacitor-only. Hosted mobile.html in a normal browser keeps the regular web behavior.
Password-protected OpenChamber servers can be unlocked from the mobile app. The app stores the issued client token with the saved connection.
The Terminal workspace surface runs its PTY on the active OpenChamber server over the shared authenticated runtime transport; it never opens a local shell on the phone or tablet. Closing the surface detaches the renderer while the server session remains available for reattachment. On touch devices, dragging scrolls the buffer while long-pressing and dragging selects terminal text.

Commands

Run these from packages/mobile, or use the root mobile:* aliases.

bun run build: builds packages/web and prepares mobile web assets.
bun run build:assets: prepares mobile assets from an existing packages/web/dist build; the root workspace build uses this to avoid rebuilding web.
bun run sync: prepares assets and runs cap sync.
bun run add:ios: creates the native iOS project.
bun run add:android: creates the native Android project.
bun run build:android:debug: builds a debug Android APK without launching an emulator.
bun run build:ios:simulator: builds an iOS Simulator app without launching Xcode or Simulator.
bun run sim:run: boots a simulator if needed, installs the built iOS app, and launches it.
bun run sim:dev: one-command dev loop — builds the simulator app, installs + launches it, starts the serve-sim stream, and prints the preview URL; Ctrl+C stops the stream. Pass --no-build to skip the build step.
bun run sim:serve: starts serve-sim in detached JSON mode and prints the browser preview URL.
bun run sim:list: lists running serve-sim streams.
bun run sim:kill: stops running serve-sim streams.
bun run open:ios: opens the iOS project.
bun run open:android: opens the Android project.

Headless Quickstart

bun run build
bun run sync
bun run build:ios:simulator
bun run build:android:debug

These commands build and sync the native projects without launching Xcode, Android Studio, Simulator, or an emulator.

Local Tooling

The default scripts assume the local Homebrew/Xcode paths prepared for this workspace:

Xcode: /Applications/Xcode.app/Contents/Developer
JDK 21: /opt/homebrew/opt/openjdk@21
Android SDK: /opt/homebrew/share/android-commandlinetools

Override DEVELOPER_DIR, JAVA_HOME, ANDROID_HOME, or ANDROID_SDK_ROOT when using a different local setup.

Required local tools:

Xcode with iOS Simulator support.
CocoaPods for iOS dependency installation.
JDK 21 for Android Gradle builds.
Android SDK command-line tools with platform/build-tools 35.

Troubleshooting

If xcodebuild reports that the active developer directory is Command Line Tools, keep using the provided scripts or set DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer.
If Android builds fail with Unable to locate a Java Runtime or source release: 21, install/use JDK 21 and set JAVA_HOME accordingly.
If Android SDK packages are missing, install platform-tools, platforms;android-35, and build-tools;35.0.0, then accept SDK licenses.
If CocoaPods cannot find Capacitor pods after reinstalling dependencies, run bun install from the workspace root, then rerun bun run sync.
If connecting to a remote OpenChamber server fails from the app while /health works in curl, check that the server build includes the packaged-client CORS allowlist for capacitor://localhost and local dev origins.
If serve-sim preview says the stream is not producing frames, check the raw MJPEG stream before assuming the simulator stopped. In prior testing the raw stream worked while the browser preview UI stayed stale.

Generated Assets

The native projects currently use Capacitor-generated launcher and splash assets. Replace them before release branding work.