Mobile App Guide (Android)

Why use the mobile app

The mobile app is the strongest way to capture evidence: photos are taken through a verified camera flow, stamped with GPS and capture time, and carry device provenance that the web upload path can't provide. Reviewers see this reflected in each capture's integrity analysis.

Installation

The app is distributed privately through Firebase App Distribution. Your organization's administrator requests access for your Google account; you'll receive an email invitation with installation steps. Accept the invite, install the Firebase App Tester app if prompted, and download Terminus from there. Updates arrive the same way.

Registration & sign-in

Ask your administrator for an invite (they can email it to you or show you a QR code). Open the link or scan the code with your phone, then follow the registration steps to set your name and password. Afterwards sign in with your email and password. Managers and admins are prompted to set up a passkey used to cryptographically sign the evidence they capture.

Orders

The Orders tab lists your organization's orders. Depending on your role and organization settings you can create orders directly: tap New Order and fill the fields, or use Scan to create one from a barcode or QR code on the freight — the scanned value becomes the order identifier.

Capturing evidence

1. Open the order and tap Capture Evidence.
2. Allow the location permission when asked — GPS anchors where the capture happened.
3. Photograph the merchandise with the in-app camera. You can add multiple photos; gallery imports are allowed but marked as file uploads in the integrity analysis.
4. Pick the exception type, add notes, and submit. If you're offline or GPS is unavailable, submission still works — the capture is simply marked accordingly.

Troubleshooting

• Camera or location permission denied — enable them in Android Settings → Apps → Terminus → Permissions, then reopen the capture screen.
• "Monthly order limit reached" — your organization's plan hit its order cap for this month; ask your admin about upgrading.
• Sign-in loops or session errors — check the device clock is set to automatic; tokens are time-sensitive.
• Invite link says expired — invites have an expiry date; ask your administrator for a fresh one.