Skip to main content

Zgrid Mobile Runbook

Last reviewed: 2026-04-21
Maintained by: Engineering

Purpose​

apps/zgrid-mobile is the Expo mobile app for tenant and technician user flows.

Run Locally​

Start Expo:

EXPO_PUBLIC_API_URL=http://127.0.0.1:3000/api pnpm run dev:zgrid-mobile

Start on device targets:

EXPO_PUBLIC_API_URL=http://127.0.0.1:3000/api pnpm run ios:zgrid-mobile
EXPO_PUBLIC_API_URL=http://10.0.2.2:3000/api pnpm run android:zgrid-mobile

Prerequisite:

  • API should run on http://localhost:3000

Key Folders / Where Logic Lives​

  • App routes/screens: apps/zgrid-mobile/app
  • Reusable UI and helpers: apps/zgrid-mobile/src/components
  • Providers/state wiring: apps/zgrid-mobile/src/providers
  • Client utils/config/storage: apps/zgrid-mobile/src/lib

Minimum PR Checks​

pnpm run check:zgrid-mobile
pnpm run lint:zgrid-mobile

How to Debug Startup Failure​

  1. Verify API base URL is correct for your target:
  • iOS/macOS: http://127.0.0.1:3000/api
  • Android emulator: http://10.0.2.2:3000/api
  1. Restart Expo:
pnpm run dev:zgrid-mobile
  1. If bundler cache is stale:
pnpm --filter @zgrid/zgrid-mobile start --clear
  1. Validate TypeScript:
pnpm run check:zgrid-mobile