Mobile app

Use xopc-app when you want to continue the same xopc assistant from iOS or Android.

xopc-app is a standalone Expo / React Native client for the xopc gateway. It does not replace the gateway: it connects to a running gateway over LAN, FRP, or your own HTTPS reverse proxy, then uses the same gateway Bearer token / pairing flow.

Quick path

1. Start your gateway:

xopc gateway

2. Pick how the phone reaches the gateway:

Situation	Recommended route
Phone and gateway on the same Wi-Fi	LAN gateway URL
Away from home, need a temporary public URL	FRP public tunnel
You own a domain and TLS cert	Reverse proxy
All devices are on Tailscale	Tailscale Serve

3. Open Gateway console → Settings → Remote access.
4. Use Mobile app pairing to scan the QR or copy the pairing link.
5. Open xopc-app and confirm the gateway base URL / token in app settings.

Gateway access options

LAN

Use LAN when the phone and gateway host are on the same Wi-Fi.

• Gateway may need to bind to a LAN IP or 0.0.0.0.
• Use token auth and your local firewall.
• Android standalone builds need HTTP cleartext enabled; xopc-app enables this in its native build config.
• iOS standalone builds need local network permission; approve the iOS system prompt for xopc.

FRP public tunnel

Use the public tunnel when you need a temporary HTTPS URL from outside your LAN or tailnet.

• Open Remote access → Public internet.
• Start the tunnel and wait for the public URL.
• Scan the Mobile app pairing QR.
• Stop the tunnel when you no longer need remote access.

Treat public tunnel exposure as high risk. Anyone with the URL or pairing QR may reach the gateway if they also obtain your Bearer token.

Reverse proxy

Use this when you already have your own HTTPS domain, such as https://gateway.example.com.

• The reverse proxy terminates TLS and forwards to the loopback gateway.
• The gateway still authenticates clients with its Bearer token.
• Mobile clients require a system-trusted TLS certificate; self-signed certificates are not supported for the app path.

Building xopc-app

The mobile app lives in a separate repo:

git clone https://github.com/xopcai/xopc-app.git
cd xopc-app
pnpm install
pnpm start

Useful commands from the app repo:

Command	Purpose
pnpm start	Expo dev server
pnpm run android / pnpm run ios	Development builds
pnpm run android:release	Android release APK
pnpm run typecheck	TypeScript check
pnpm run test:gateway-sse-client	SSE client tests

react-native-mmkv uses native code. Expo Go can run the app with in-memory fallback storage, but persistent settings require a development or standalone build.

More detail

• xopc-app repo
• Remote access
• FRP tunnel security