de235fd5fd
Adds a Release-configuration build path for the staging variant: pnpm ios:mobile:device:staging:release → cd apps/mobile && expo run:ios --device --configuration Release Release builds strip `expo-dev-launcher` from the binary (it's only linked in the Debug Pod configuration), so the installed app loads the embedded JS bundle directly — no "Downloading…" screen, no Metro probe, no Recently-opened launcher menu. Standalone use feels like an App Store install. The existing `ios:device:staging` (Debug) path is unchanged — it stays the daily-driver for hot-reload development. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Multica Mobile (iOS)
Expo + React Native iOS client for Multica. Independent from web/desktop — shares only types from @multica/core/. See CLAUDE.md for the locked tech-stack baseline and import rules.
Scripts
| Command | Env file | Backend |
|---|---|---|
pnpm dev:mobile |
.env.development.local |
your own (LAN IP of local backend) |
pnpm dev:mobile:staging |
.env.staging |
staging |
pnpm ios:mobile:device |
.env.development.local |
your own |
pnpm ios:mobile:device:staging |
.env.staging |
staging |
dev:* runs Metro only (reuse an already-installed dev-client build). ios:device:* does a full native rebuild + install onto a physically-connected iPhone.
Bundle identifier and display name switch on APP_ENV (see app.config.ts), so Dev / Staging / Production variants can coexist on the same device.
Build your own version onto your iPhone
For a self-host user who wants to run Multica mobile against their own / staging backend:
-
Get the prerequisites set up (Mac, Xcode, free Apple ID added in Xcode → Settings → Accounts, iPhone connected, Developer Mode enabled). Follow Expo's Set up your environment — pick Development build → iOS Device.
-
Copy
.env.exampleto.env.staging(or.env.development.local) and setEXPO_PUBLIC_API_URLto the backend you want to hit. -
From repo root, run:
pnpm ios:mobile:device:stagingFirst build downloads CocoaPods + compiles React Native from source — expect 10-20 minutes. Subsequent builds are much faster.
The app installs to your phone and runs without the Mac after the build completes.
7-day signing limit
A free Apple ID signs builds for 7 days only. After that the app refuses to launch. Plug back into the Mac and re-run pnpm ios:mobile:device:staging to re-sign — there is no workaround short of an Apple Developer Program account ($99/yr).
Pointing at a different backend
Edit EXPO_PUBLIC_API_URL in .env.staging (or .env.development.local), then rebuild. The value is baked into the JS bundle at compile time; runtime swaps are not supported.
For local backend testing, use your Mac's LAN IP (ipconfig getifaddr en0), not localhost.