mobile

pulsewatch-mobile

React Native companion app for pulsewatch with incident push and deep links.

GitHub repo (opens in a new tab) ↗

~/problem

On-call operators need to hear about an incident the moment it opens and land on it directly.

An Expo SDK 58 app that signs in with the pulsewatch operator account, shows live target health, SLOs and incident history, and handles push notifications in foreground, background and cold-start states. A tap deep-links to the exact incident.

~/highlights

  • Registers the raw native FCM or APNs token (not an Expo push token) because the backend speaks both provider protocols directly.
  • expo-router deep link from a push to /targets/[targetId]/incidents/[incidentId], deduplicated by notification id.
  • lib/api-types.ts mirrors the backend OpenAPI schema one to one so contract drift shows up as a diff.
  • Jest suites cover the API client, the auth state machine and push-to-navigation, including a test that renders the production hook.
  • CI runs typecheck, lint, tests, gitleaks and CodeQL; npm audit goes through a script with a dated, single-advisory allowlist.
  • Limits stated plainly: real push delivery and killed-state launch were never verified on a physical device.

~/architecture

Architecture of pulsewatch-mobileExpo app connects to API client, Push handling. API client connects to pulsewatch backend. Push handling connects to pulsewatch backend. pulsewatch backend has no outgoing connections.Expo appAPI clientPush handlingpulsewatch backend
Expo app → API client, Push handling
Server setup, login, target list, target detail, incidents, settings.
API client → pulsewatch backend
Typed client for pulsewatch /api/v1 with cookie session auth.
Push handling → pulsewatch backend
Device token registration and notification-tap deep linking.
pulsewatch backend
Self-hosted Go service in the paired repository.

~/stack

  • React Native
  • Expo SDK 58
  • TypeScript
  • expo-router
  • expo-notifications
  • Jest

~/status

Companion client with CI. Self-hosted server URL entered on first launch. AGPL-3.0.

  • pulsewatch Self-hosted uptime, SLO and alerting service with a lightweight agent.