Skip to content

Instructor features in DriveFlow Mobile

Applies to: Instructor. Last reviewed: 2026-11-18.

This page describes every screen an instructor gets in the app. Instructors see the Instructor workspace: their own lessons, their own students, and the sign-off that completes a lesson.

Who gets these screens: an account whose only role is Instructor. An instructor who also holds another staff role (for example Manager) gets the school management screens instead; see Owner and staff features.

Plan features needed: Mobile App, and Bookings for the lesson screens.

Your account must be linked to your instructor profile

Important

The lesson screens work out who you are from your account, never from anything the phone sends. Your DriveFlow user account has to be linked to your instructor profile.

  • The first time you open a lesson screen, DriveFlow links your account automatically to the instructor profile at your school that has the same email address as your account.
  • After that the link is permanent.
Message What to do
"Your account isn't linked to an instructor profile. Ask your school to check that your instructor profile uses the same email address as your DriveFlow account." Ask the school to correct the email on your instructor profile (or on your user account) on the website so they match
"More than one instructor profile at your school uses your email address. Ask your school to correct the instructor profiles." The school has two instructor profiles with your email. They must fix one of them; DriveFlow will not guess

A profile at another school is never linked, even with the same email.

The instructor menu

Items appear only when your role has the permission shown. With the standard Instructor role you normally see most of them.

Section Menu item Permission needed Screen
WORKSPACE Dashboard none Instructor Dashboard
WORKSPACE My Lessons Lessons.View My lessons
WORKSPACE My Students Students.View My students
WORKSPACE Instructors Instructors.View Instructors list (your colleagues)
WORKSPACE Vehicles Vehicles.View Vehicles list (the school's cars)
LESSONS Sign-off Lessons.Edit Lessons to finish
LESSONS Kilometre Log Fleet.Log or Fleet.Manage, and the Fleet plan feature Kilometre log
ACCOUNT Profile none Profile
ACCOUNT Settings none Settings

The Instructors and Vehicles screens are the same ones staff use. They are view-only unless your role may also add or edit them.

Instructor Dashboard

Screenshot to be added

Screen: Instructor Dashboard. Should show: TODAY / COMPLETED / TO GO tiles, the NEXT LESSON card and today's lesson list.

  • Hello, <first name> and "Today's lessons · <today's date>".
  • Tiles: TODAY (lessons today), COMPLETED, TO GO.
  • NEXT LESSON: time (with the date if it is not today), student name, vehicle registration, licence code and pick-up place. Tap it to open the lesson.
  • Today's lessons: one line per lesson with start time, length in minutes, student, vehicle registration, licence code and a status badge. Tap a line to open the lesson. "No lessons today." when empty.
  • If loading fails: the error and a Try again button.

Only your own lessons are ever shown. API: GET api/instructor/dashboard.

My lessons

Your lessons for one day.

  1. Open the menu and tap My Lessons. Today is shown.
  2. Tap ‹ or › to move a day, or tap the date to choose one.
  3. Tap a lesson to open it. "No lessons on this day." when there are none.

API: GET api/instructor/lessons?from=…&to=… (one request covers at most 62 days; the app asks for one day at a time).

Status badges

Badge Meaning
Scheduled Booked, not yet confirmed by the student
Confirmed Confirmed
In progress You started it
Awaiting your sign-off The lesson is waiting for the instructor's signature. Nothing in the application (website or app) sets this status, so in practice it does not appear
Awaiting student You have signed; the student has not
Completed Both have signed
Cancelled / No show Did not take place

Lesson details

Tap any lesson. The screen is headed LESSON <number> with the student's name, the date, start and end time, length and status.

Sections:

  • STUDENT: Student number, Phone, Other phone, Email.
  • LESSON: Licence (code and name), Vehicle (registration and name), Branch, Pick up, Drop off.
  • NOTES: the notes on this lesson, or "No notes yet."
  • EARLIER LESSONS: the student's previous lessons with date, instructor, status and notes. "This is the student's first lesson." when there are none.

Buttons at the top depend on the status:

Status Button
Scheduled or Confirmed Start lesson
In progress Complete and sign off
Awaiting student Student to sign
Any, when the student has a phone number and the device can dial Call <first name> (opens the phone's dialler with the number filled in)

"This lesson isn't one of yours, or it no longer exists." appears if you open a lesson that belongs to another instructor. You can neither see nor change another instructor's lessons through these screens.

API: GET api/instructor/lessons/{id}.

Start a lesson

Needs: Lessons.Edit.

  1. Open the lesson.
  2. Tap Start lesson.
  3. The status changes to In progress and the button becomes Complete and sign off.
Message Why
"Cancelled lessons cannot be started." The lesson was cancelled
"Completed lessons cannot be started." It is already complete
"Lesson is already in progress." It was already started
A message beginning "A lesson can't be started" The server refused to start a lesson dated in the future. This depends on your branch's settings

API: POST api/instructor/lessons/{id}/start.

Complete and sign off a lesson

In the app a lesson is completed by two signatures on one device: yours, then the student's. There is no separate "complete" button.

Needs: Lessons.Edit. The lesson must be In progress.

flowchart TD
    A[Start lesson] --> B[Progress notes + instructor signature<br/>Sign and continue]
    B --> C[Hand the device to the student<br/>I'm name, continue]
    C --> D[Student checks the lesson + signs<br/>Sign and complete lesson]
    D --> E[Lesson completed]
  1. On the lesson, tap Complete and sign off. The SIGN-OFF screen opens with four progress markers.
  2. Progress notes: type what went well and what to practise next. Notes are optional.
  3. Your signature: sign with your finger in the box. Tap Clear to start again.
  4. Tap Sign and continue. The server answers "Signed. Hand the device to the student to sign." The lesson is now Awaiting student.
  5. The screen shows Hand the device to <student's first name> and "Your sign-off is saved. Ask <name> to check the lesson and sign to confirm it." Give the phone to the student.
  6. The student taps I'm <name>, continue.
  7. The student sees YOUR LESSON (when, vehicle, and the notes you just wrote), then signs under Student signature. "By signing you confirm this lesson took place".
  8. The student taps Sign and complete lesson.
  9. Lesson completed: "The signed lesson is saved and shows as completed in DriveFlow." Tap Back to dashboard or View lesson.

Screenshot to be added

Screen: Sign-off step 1. Should show: Progress notes box and the instructor signature pad with a drawn signature.

Screenshot to be added

Screen: Sign-off step 3. Should show: the YOUR LESSON card and the Student signature pad.

Completing the lesson does everything a completion on the website does: the student's training progress is updated, instructor earnings are recorded where the school uses them, and the completion notification goes out.

If the student cannot sign now

Your signature is already saved after step 4. You can stop there. Later, either:

  • open the lesson (or the Sign-off list) and tap Student to sign to continue on your phone; or
  • the student signs on their own phone from My Lessons › Sign off this lesson (Student features).

The signature rule

A signature is sent as a PNG image. The server refuses anything else before saving it.

Message Why
"Please sign in the box." Nothing was drawn
"Instructor signature is required." / "Student signature is required." An empty signature reached the server
"… signature must be a PNG image." The image was not a valid PNG
"… signature is too large." The image is over 512 KB (a drawn signature is far smaller)
"Start the lesson before signing it off." The lesson is not In progress
"Cancelled lessons cannot be signed off." / "No-show lessons cannot be signed off." / "Lesson is already completed." / "Instructor sign-off has already been completed." The lesson is in the wrong state
"This lesson is not awaiting student sign-off." The student step was tried before your signature

If sending fails, your notes and the drawn signature stay on the screen so you can tap the button again.

Warning

Rotating the phone clears the signature box.

API: POST api/instructor/lessons/{id}/sign-off (signature and notes), POST api/instructor/lessons/{id}/student-sign-off (signature).

Example

Sipho finishes a 10:00 lesson with Thandi. He opens the lesson, taps Complete and sign off, types "Good clutch control. Practise parallel parking next time.", signs and taps Sign and continue. He hands Thandi the phone. She taps I'm Thandi, continue, reads the note, signs and taps Sign and complete lesson. Both see Lesson completed.

The sign-off list

Menu: Sign-off. Heading Lessons to finish: "Lessons you've started, or that are waiting for the student to sign, from the last 14 days."

  • Lists your lessons that are In progress or Awaiting student, from 14 days ago to tomorrow, with their date.
  • Tap one to continue its sign-off at the right step.
  • "Nothing to sign off. Start a lesson from your dashboard or My Lessons." when empty.

My students

Menu: My Students. "Students assigned to you, or with lessons with you." The list holds students whose own instructor you are, and students you have taught recently or are booked with.

Each line shows the name, student number, licence code, how many lessons they have completed with you, and either Next: (next lesson with you), Last: (last lesson) or "No lessons yet". The phone number is a link that opens the dialler. The badge reads Yours for students assigned to you, otherwise the student's status (for example In training).

A search box, Search by name or student number, appears once you have more than six students.

This list is view-only: tapping a student does not open a record. API: GET api/instructor/students.

Limitations and notes

  • No "no-show" button. An instructor cannot mark a lesson as a no-show from the app. The instructor API has no endpoint for it. Use the website, or ask the office.
  • No cancel or reschedule. Instructors cannot cancel, move or book lessons from the instructor screens.
  • The status "Awaiting your sign-off" is never set. No screen or process in the website or the app moves a lesson to it, so the app's handling of it does not come into play in normal use. If a lesson did carry it (for example after a direct database change), the app would show no Start or sign-off button, would leave it out of the Sign-off list, and the sign-off screen would say "This lesson is awaiting your sign-off. Start it from the lesson page before signing off." The server only accepts the app's instructor signature for a lesson that is In progress.
  • Notes can only be added at sign-off. There is no way to edit a lesson's notes before or after signing. Notes written at sign-off are added to the lesson's existing notes.
  • No assessment form. There are no skill ratings or assessment checklists in the app; only free-text progress notes.
  • No earnings screen. Instructor earnings are not shown anywhere in the app.
  • One day at a time. My Lessons has no week view. Staff with the school management screens have a day and week Schedule.
  • No student record. My Students is a list only; there is no per-student page in the instructor workspace.
  • Starting early. The app does not stop you starting a lesson before its time on the same day. Any date rule is the server's.