📱 Mobile App

Tellia's mobile app is an Expo 55 + React Native 0.83 field application for iOS and Android. It uses the New Architecture, experimental React Compiler (React 19), and file-based routing via Expo Router.

IMPORTANT

The app uses Expo prebuild (managed native build). Expo Go is not supported — you must run pnpm --filter @tellia-solutions/mobile-app ios or pnpm --filter @tellia-solutions/mobile-app android which build the native project.

Tech Stack

Layer	Technology
Framework	Expo 55 / React Native 0.83
Routing	Expo Router (file-based)
Auth	@react-native-firebase/auth (native modules)
Styling	Uniwind (Tailwind → RN styles) + CVA
Data fetching	TanStack Query v5
Maps	@rnmapbox/maps v10 + Turf.js
Error tracking	Sentry (@sentry/react-native v8)
Feature flags	Firebase Remote Config
Offline storage	MMKV
Bottom sheets	react-native-actions-sheet

Quick Commands

pnpm --filter @tellia-solutions/mobile-app start       # Expo dev server
pnpm --filter @tellia-solutions/mobile-app ios         # Run on iOS simulator
pnpm --filter @tellia-solutions/mobile-app android     # Run on Android emulator
pnpm --filter @tellia-solutions/mobile-app lint        # ESLint
pnpm --filter @tellia-solutions/mobile-app check-types # TypeScript check

Sections

• 💻 Local Dev Setup — Prerequisites, env vars, Firebase config, running the app
• 🏛️ Architecture — Routing, auth guards, theming, bottom sheets
• 🌐 API & Data Layer — HTTP client, TanStack Query, custom hooks
• 📴 Offline Sync & Feature Flags — Offline queue, feature flag system
• 🗺️ Map & Geospatial — Mapbox setup, layers, drawing, parcels
• 🚀 Build & Submit — EAS Build profiles, store submission, service account setup