Notifications and reminders on the phone¶
Applies to: Student, Instructor (push notifications); Student (lesson reminders); Owner and Administrator (set-up). Last reviewed: 2026-11-18.
The app can show two kinds of notification:
| Kind | Sent by | Who gets it | Needs internet at the time? |
|---|---|---|---|
| Push notification | The DriveFlow server, through Firebase Cloud Messaging | Students and instructors, on Android | Yes |
| Lesson reminder | The phone itself, scheduled from the lessons the app has loaded | Students | No |
Push notifications are an extra channel next to the email, SMS and WhatsApp messages a school already sends. For which events exist and when each is triggered, see Notification triggers.
Push notifications¶
What you need to receive them¶
All of these must be true:
- You are signed in to the app on an Android phone.
- Your school's plan includes the Mobile App feature.
- Push notifications is on in the app's Settings (it is on by default).
- Android allows notifications for DriveFlow (Android 13 and later ask you once).
- Your school has notifications switched on and the event in question enabled.
- The DriveFlow server has push configured (see Set-up status).
Turning them on or off¶
- Open the menu and tap Settings.
- Under This phone, tick or untick Push notifications.
- The message confirms the change.
Turning them off removes this phone from your school's list and drops the phone's push token, so nothing more arrives. Turning them on registers the phone again. The choice is kept on the phone, not on your account.
Tip
If you see "Notifications are blocked for DriveFlow on this phone.", tap Open phone settings and allow notifications there.
How a phone is registered¶
- The phone registers itself automatically after sign-in, once the plan check has passed. You do nothing.
- It registers again whenever Firebase issues the phone a new token.
- It is removed when you sign out, when you turn push off, and when the session ends for any other reason.
- If someone else signs in on the same phone, the phone now belongs to them. A phone only ever receives the notifications of the person signed in on it.
- You can be signed in on several phones; each receives your notifications.
- If a phone can no longer be reached (the app was removed or reinstalled), the server deletes it from the list the next time it tries.
Registration failures are ignored and tried again at the next sign-in. Push is treated as a convenience and never blocks the app.
API: POST api/mobile/push/devices and POST api/mobile/push/devices/remove, each with the phone's token and the platform android.
Which events are pushed¶
A push is added to every notification event the school has enabled, when the recipient of that event is a student or an instructor with the app. There is no separate "push" tick box per event in the school's notification settings.
The rules, in order:
- The school's notification settings exist and are active.
- The event is enabled for the school (Settings › Notifications).
- It is not quiet hours, unless the event is one that always goes out immediately (lesson booked, cancelled, rescheduled, completed, request declined, payment received, and the instructor's lesson assigned, rescheduled and cancelled). Invoice Issued is not pushed: a new invoice is only emailed, directly with its PDF, and never goes through the notification engine, so it gets no push, SMS or WhatsApp.
- The school's plan includes the Mobile App feature.
- The recipient has at least one phone signed in. A recipient without the app is skipped silently.
A student's phones are found by their student record. An instructor's phones are found by the user account linked to their instructor profile.
The notification's title is the message's subject and its text is the plain-text message, shortened to 240 characters. Each push is recorded in the school's notification log with the address "DriveFlow app (1 device)".
What happens when you tap one¶
The app opens (or comes to the front). If you are not signed in, or the plan check has not finished, the notification waits and opens its screen once you are through.
| You are | Event | Screen opened |
|---|---|---|
| Student | PaymentReceived, PaymentReminder (InvoiceIssued is also mapped here, but no invoice push is sent) | Payments & Invoices |
| Student | LessonBooked, LessonReminder, LessonRescheduled, LessonCancelled, LessonCompleted | My Lessons |
| Student | LessonRequestDeclined | My Requests |
| Student | anything else (for example StudentWelcome, DrivingTestReminder) | Student Dashboard |
| Instructor | InstructorDailySchedule, or an event with no lesson | My Lessons |
| Instructor | any event about one lesson | That lesson's page |
| Staff in the Owner workspace | any | Dashboard |
How they look¶
- Notifications appear in the Android channel Lesson updates, described as "Bookings, changes to lessons, reminders and payments from your driving school." You can change its sound and importance in the phone's settings.
- The small icon is the white DriveFlow "D".
- When the app is closed or in the background, Android shows the notification. When the app is open, the app shows it itself so that it is not missed.
Screenshot to be added
Screen: Android notification shade. Should show: a "Lesson updates" push notification from DriveFlow with the white D icon.
Set-up status¶
| Part | State in the code |
|---|---|
| Android app: Firebase Messaging library, messaging service, notification channel, token registration, tap handling | Built |
Android app: Firebase project file (google-services.json) |
Included in the project and referenced by the build |
API: device registration endpoints and the PushDevices table |
Built |
| API: push channel in the notification engine | Built and covered by tests |
| API: Firebase sender | Built. Off until the Firebase credentials are configured on the server |
| iOS push (APNs) | Not built |
When the Firebase credentials are not configured, the server logs that push notifications are off and simply sends nothing by push; email, SMS and WhatsApp are unaffected. If the configured credentials are missing or unreadable, an error is logged and push stays off. The server configuration is covered in the internal technical documentation.
Whether push is switched on in the live environment depends on that server configuration and cannot be told from the code.
Lesson reminders on the phone¶
Students get reminders that the phone schedules itself. No server and no internet connection is involved when they fire.
What you get¶
For each upcoming lesson (up to the next 10, not counting cancelled ones):
| When | Title | Text |
|---|---|---|
| 18:00 the evening before | Driving lesson tomorrow | "Tomorrow at 09:00 with Sipho Dlamini. Pick-up: 12 Main Road." |
| One hour before | Driving lesson in an hour | "At 09:00 with Sipho Dlamini. Pick-up: 12 Main Road." |
The pick-up sentence is left out when the lesson has no pick-up place. A reminder whose time has already passed is not scheduled.
When they are set¶
- Every time the Student Dashboard loads, the reminders are cleared and scheduled afresh from your current upcoming lessons.
- When you turn Lesson reminders back on in Settings.
They are cleared when you sign out and when you turn them off.
Important
Reminders follow what the phone last loaded. If your school moves or cancels a lesson, the reminder on your phone changes only after you next open the dashboard. Open the app now and then to keep them right.
Turning them on or off¶
- Open the menu and tap Settings.
- Under This phone, tick or untick Lesson reminders.
The first time reminders are scheduled, Android may ask whether DriveFlow may show notifications. If you refuse, no reminders are shown and the app carries on normally.
Example¶
Thandi has a lesson on Wednesday at 09:00. She opens the app on Monday. Her phone will show "Driving lesson tomorrow" on Tuesday at 18:00 and "Driving lesson in an hour" on Wednesday at 08:00, even if she has no data on Wednesday morning.
Push and reminders together¶
A student can receive both a school LessonReminder push and the phone's own reminder for the same lesson. They are independent. Turn off Lesson reminders in the app if you only want the school's messages, or Push notifications if you only want the phone's.
Limitations and notes¶
- Android only. On any other platform the Settings screen reads "Push notifications aren't available on this device yet." and no token is requested.
- Owners and other staff do not receive push notifications. The server looks up phones only for student and instructor recipients. Staff phones are still registered, and the Push notifications switch is shown to them with the text "Updates about your lessons, sent by DriveFlow.", but no current event is addressed to them unless they are also the instructor on a lesson and their account is linked to that instructor profile.
- No in-app notification list for staff or instructors. Students have Messages, which lists what the school sent them by email, SMS or WhatsApp.
- No reminders for instructors or staff. Phone-scheduled reminders are for students only. Instructors get only the lesson notifications (lesson assigned, rescheduled, cancelled). The Daily Instructor Schedule (InstructorDailySchedule) exists as a setting and has message text, but nothing in the server sends it, so instructors receive no daily schedule.
- Reminder times are fixed at 18:00 the evening before and one hour before. They cannot be changed.
- Tapping a lesson reminder opens the app but does not jump to the lesson; only push notifications open a specific screen.
- Token mode. The app and the server use Firebase registration tokens. Firebase marks these calls as deprecated in favour of installation IDs; the code notes that both sides must move together when that is done. Nothing is broken today.
- Push debug traces (
DriveFlowPush:lines) are written only by debug builds and never include the token.
Related articles¶
- Push notifications - push from the school's point of view
- Notification triggers - which events send which messages
- Notification configuration - the school's notification settings
- Profile and settings - the This phone switches
- Troubleshooting - when notifications do not arrive