Phone app

An Android app for staying on top of work away from the desk: your inbox, issues, comments and status changes, filing new issues (the New issue button on My work), and push notifications.

Install

Open /get-app on your phone, or scan its QR code from a computer.
Download the APK. Android asks you to allow installs from your browser the first time.
Sign in with your NextForge account and allow notifications.

It isn't in the Play Store. Small updates arrive by themselves in the background; bigger ones ask you to install a new APK.

Notifications

You get a push for assignments, mentions, comments and status changes on your issues, pushes to a project's main branch and failed builds. Tapping one opens the issue (or the GitHub run).

For whoever releases the app

Build settings

Passed at build time, nothing secret:

Setting	What
`API_URL`	The API, e.g. https://api.example.com
`WEB_URL`	The web app, for links
`ONESIGNAL_APP_ID`	The OneSignal app id. Without it the app has no push.

New APK

For native or dependency changes, or the first release. Bump version: in pubspec.yaml first; the build number after + must go up.

cd apps/mobile
shorebird release android --artifact apk -- \
  --dart-define=API_URL=https://api.example.com \
  --dart-define=WEB_URL=https://app.example.com \
  --dart-define=ONESIGNAL_APP_ID=<app id>

Upload build/app/outputs/flutter-apk/app-release.apk in Admin → Mobile app. Tick Required update only when older builds can't work with the server any more.

Patch

For Dart-only fixes. Installed apps pick it up on their next launch, no new APK:

shorebird patch android

Shorebird reads SHOREBIRD_TOKEN from the environment; keep it in apps/mobile/.env or CI secrets, never in git.

Push setup

Push goes through the same OneSignal app as email. In OneSignal, add your Firebase (FCM) credentials under the app's Android settings, then set ONESIGNAL_APP_ID and ONESIGNAL_API_KEY on the API (see Self-hosting → settings).