Obsidian Jet Docs

Get the app and register your device

Install the crew mobile app, sign in, and register your device so push notifications work.

The crew mobile app (apps/crew) is a separate, offline-first companion to the crew web portal — it is what you carry on the road. This page gets you signed in and registered for push.

Steps

  1. Install and open the app. It launches to a spinner while it checks whether you are already signed in.
  2. Sign in. Depending on how your operator has configured identity, you either sign in with your Obsidian Jet identity through the sign-in screen, or (in a dev/demo build) pick your name from a roster list. Either way you land on the Today tab once signed in.
  3. Choose an organization, if asked. If your account belongs to more than one operator, you are dropped on a Choose an organization screen first — pick the one you are flying for. An account with a single operator skips this screen entirely.
  4. Allow notifications when prompted. On first launch the app asks for notification permission. Allow it — this is what lets dispatch reach you about a new assignment, a retime, or a removal without you having to poll the app.
  5. Your device registers itself. Once notifications are allowed, the app asks Expo for a push token and posts it to POST /api/v1/crew/devices with your platform (iOS/Android) and app version. This call is what creates your crew_device row — the registration a push actually depends on. If you decline the permission prompt, or you are running in a simulator that cannot receive push, the app skips registration silently and you simply will not receive push (you can still see everything by opening the app).
  6. Re-registering. Reinstalling the app, or signing out and back in, repeats step 5 automatically — each registered token is upserted by its Expo push token, so having the app on two devices registers two rows and you get push on both.

A crew_device row is what push depends on — no row, no push. If you stop getting assignment pushes, check that notifications are still allowed for the app in your device settings; the app cannot re-register a token it was never granted.

What's next

Once you're signed in, see your schedule and assignments or check your duty and rest.

On this page

Get the app and register your device — Obsidian Jet