Mobile

apps/mobile is the Expo app. It uses React Native, Expo Router, NativeWind, and the shared @halostack/ui-mobile package.

Role

The mobile app is a deployable client, not a shared package. It consumes the API and auth stack, loads the mobile design tokens, and owns mobile-specific routing, theme wiring, fonts, secure auth storage, and platform configuration.

Local workflow

Copybun run dev:mobile
# or from the app
bun run --filter mobile dev
bun run --filter mobile ios
bun run --filter mobile android

The main bun run dev excludes mobile so web/API/docs/landing can run without starting Metro.

UI and tokens

Mobile UI comes from @halostack/ui-mobile. Its globals.css is generated from the web UI tokens by @halostack/design-tokens, so web and native share one palette source while mobile receives React Native-compatible literal colors.