Mobile / Getting started
Run the mobile app
Connect Expo to a reachable development API.
Setup and configuration
Install the workspace dependencies first. Set EXPO_PUBLIC_API_URL to an API origin reachable by your simulator or phone and EXPO_PUBLIC_APP_SCHEME to the app scheme. Start the web API before testing authenticated native flows.
pnpm --filter @starterkit/mobile start
pnpm --filter @starterkit/mobile android
pnpm --filter @starterkit/mobile iosImplementation workflow
Use the platform command supported by your host; the iOS simulator requires an appropriate macOS development environment. A phone's localhost refers to the phone, not your development computer. Confirm network reachability when the app cannot contact the API.
Review apps/mobile/app.config.ts before testing deep links. Public Expo variables are bundled into the client and must never include database, billing, authentication signing, or AI-provider secrets.
Verification and troubleshooting
Verify API reachability, sign-in, returning to the app, session restoration, and sign-out. Test both a fresh installation and a returning session. A desktop browser preview is not native-device acceptance.