Documentation

Managing Passengers

Passengers are the people whose transportation you want to track - your children, family members, employees, or anyone using the service.

The Passengers Screen

Tap Passengers from the home screen to open the passengers list. If you have no passengers yet, you'll see an empty state with an Add Passenger prompt. If you have passengers, each one appears as a card showing their photo, name, and status.

A fixed button at the bottom of the screen lets you add a new passenger at any time.

Passenger Card

Each passenger card shows:

• Avatar with a colored status chip:
  • Green chip: Passenger is verified
  • Yellow chip: Pending email verification
• Name and email (or a "Pending Verification" warning if not yet verified)
• Stops button — tap to open the stop assignment map for that passenger (disabled until the passenger is verified)
• BLE Beacon button — only visible when your organization has BLE attendance enabled and the passenger has at least one assigned stop; shows in blue if a beacon is already registered
• Route rows — one row per assigned route, showing the route name, shift name, and shift hours. Each row has a Track button:
  • During an active shift: button is highlighted and tapping opens the live tracking map
  • Outside the shift window: button shows a countdown timer (e.g. 02:15:30) and is disabled

Adding a Passenger

Tap the + Add Passenger (or + Add Another Passenger) button at the bottom of the screen. A full-screen modal opens.

Method 1: Add by Passenger Code

At the top of the modal you'll see a Passenger Code field. Enter the code provided by your organization's transportation coordinator and tap Add by Code. The passenger is linked to the correct route and stops automatically.

If you don't have a code, tap the separator ("or create manually") and use the form below.

Method 2: Create Manually

Fill in the form fields:

1. Photo (optional) — tap the photo area to choose an image from your gallery
2. Name (required) — full name of the passenger
3. Email (required) — used to send the passenger a verification email and stop-arrival notifications
4. Stop Arrival Notifications — toggle on to send email alerts when the vehicle arrives at the passenger's stop
5. Phone (optional) — contact phone number

Tap Add Passenger to save. The passenger will receive a verification email at the address you entered.

Editing a Passenger

Tap the passenger's avatar or name on the card to open the edit modal. Update any fields and tap Save Changes.

Fields you can edit:

• Photo (upload a new one or remove the existing)
• Name
• Stop Arrival Notifications toggle
• Phone

Deleting a Passenger

1. Tap the passenger's avatar or name to open the edit modal
2. Tap the red Delete Passenger button at the bottom
3. A confirmation dialog appears — tap Delete to confirm

Deleting a passenger removes all their data permanently. This cannot be undone.

Passenger Verification

When you add a passenger manually, they receive an email with a verification link. Until they verify:

• Their card shows a yellow chip and a "Pending Verification" label
• The Stops button is disabled

Once verified, the chip turns green and all features become available.

BLE Beacon Assignment

If your organization uses Bluetooth beacon-based attendance, a BLE Beacon button appears on the passenger card (once they have at least one assigned stop). Tap it to open the Beacon Assignment screen.

See the BLE Beacon section below for full details.

BLE Beacon Assignment

The Beacon Assignment screen links a physical Bluetooth beacon to a passenger so the system can automatically detect when they board or alight.

Opening the Screen

On the passenger card, tap the BLE Beacon button (Bluetooth icon). The screen shows:

• The passenger's name, photo, and a Registered / Not Registered badge
• If a beacon is already linked, its ID is shown in a green box labeled "Current Beacon"

Scanning for Beacons (Native App Only)

On a physical device, a Scan panel appears:

1. Tap Start Scan — the app scans for nearby Bluetooth beacons
2. Detected beacons appear in a list. Each entry shows:
   • Beacon name (or "Unknown Device")
   • Beacon type badge: Eddystone or iBeacon (only supported types are listed)
   • Beacon ID in monospace text
   • Signal strength bars (1–4 bars based on RSSI)
3. Tap a beacon in the list to select it — its ID is automatically filled into the input at the bottom and the scan stops
4. Tap Stop Scan at any time to stop scanning

If no beacons are found within 5 seconds, a "No devices found yet" message appears.

Entering a Beacon ID Manually

At the bottom of the screen there is a Beacon ID text field. You can type or paste a beacon ID directly if you know it. Accepted formats:

• Eddystone: xxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxx (20 hex chars : 12 hex chars)
• iBeacon: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:major:minor

The field turns red if the format is invalid.

Saving the Beacon

Tap Save to link the beacon ID to the passenger. A success notification confirms the save. The beacon badge on the passenger card turns blue to indicate a registered beacon.

Removing a Beacon

If a beacon is already registered, a red Remove Beacon button appears below the Save button. Tap it to unlink the beacon from the passenger.