Mobile App Setup

The NomadFlowCode mobile app is built with Expo and React Native. It connects to your NomadFlowCode server to manage repos, features, and terminal sessions.

Tech stack

• Expo SDK with Expo Router (file-based routing)
• React Native with New Architecture
• WebView for terminal display (loads a bundled xterm.js environment)

Installation

Development build

cd nomadflowcode
pnpm install
npx expo run:ios
# or
npx expo run:android

Expo Go (limited)

The app uses native WebView features that may not be fully supported in Expo Go. A development build is recommended.

Adding a server

QR code scanning (recommended)

The fastest way to connect is to scan the QR code displayed by the server:

1. Start the server with nomadflow serve (or nomadflow serve --public for remote access).
2. Open the NomadFlowCode app and tap Scan QR Code.
3. Point your camera at the QR code in your terminal. Done.

The QR code encodes a deep link (nomadflowcode://add-server?url=...&secret=...) that the app handles automatically — no manual entry required.

Manual entry

1. Open the app and tap Add Server (or the + button).
2. Enter the server details:
   • Name — a friendly label (e.g. "Home Server")
   • API URL — your server's address and port (e.g. http://192.168.1.100:8080)
   • Auth Token — the auth.secret from your server's config.toml
3. Tap Save. The app will test the connection via the /health endpoint.

Connection

The app communicates with the server over:

• HTTP — REST API calls to /api/* endpoints with Bearer token auth
• WebSocket — terminal data via /ws/panes using a binary multiplexed protocol, authenticated via Sec-WebSocket-Protocol: bearer.<secret>.

Server configuration is stored locally on the device and persists across app restarts.