runbookify
← All plans
Facilities, Assets & IT Operations / Fleet & Vehicle Management

Driver License & Eligibility Check: Never Assign a Vehicle to a Lapsed Driver

Track every authorized driver's license class, expiry, endorsements, and required training/medical — then automatically flag anyone whose eligibility lapses so they can't be put behind the wheel, with a safety manager approving each Eligible status.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you import your drivers and their license scans, AI computes each driver's eligibility from license + training + medical expiries, alerts you before anything lapses, your safety manager reviews the documents and approves Eligible status, and you export a clean eligible-driver roster as CSV.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A driver list (CSV/sheet) with license number, class, expiry, endorsements, and training/medical dates
  • License document scans (PDF/JPG/PNG)
  • Claude Code or any AI coding agent

The problem this kills

Somewhere in your fleet operation there's a spreadsheet of drivers, and somewhere on it is a license that expired three weeks ago — but the dispatcher didn't know, so that driver got keys this morning. License classes, endorsements, DOT medical cards, and refresher training all expire on their own schedules, and keeping them straight by eyeballing a sheet is exactly the kind of job that fails quietly until an auditor, an insurer, or an incident finds the gap for you.

The cost of one lapse isn't a typo — it's an uninsured driver behind the wheel, a failed compliance audit, or a liability nightmare after a crash. You don't need to live with that risk, and you don't need to be a developer to close it. You need a tool that watches the dates for you, warns you before something lapses, and refuses to mark anyone Eligible until a real person has reviewed their documents.

What you'll build

A simple internal web tool. You import your driver list (license number, class, expiry, endorsements, training and medical dates) from a CSV or Google Sheet, and you upload each driver's license and document scans into secure storage. The tool dedupes drivers by license number, computes each driver's eligibility from all of their expiry dates — license, endorsements, training, medical — and figures out exactly which item is closest to lapsing. It shows your fleet/safety manager a clear worklist: who's current, who's expiring soon, who's already lapsed. The manager opens a driver, reviews the actual scans, and clicks Approve to set them Eligible — and the moment any required document lapses, the tool flips them to Not-eligible and requires re-approval. It emails alerts before and at each lapse, and exports a clean eligible-driver roster as CSV your dispatch system can read.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — how you authorize drivers today, what your driver sheet's columns are actually named, which license classes and endorsements your fleet requires, what training and medical checks you mandate, how far ahead you want warnings, your typical and peak driver counts, and your messy edge cases — and then it tailors the data model, the eligibility rules, and every later step to your answers. This is not a generic template; the agent reflects a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through the driver import, the secure document upload, the eligibility computation, the lapse alerts, the manager review-and-approve screen, and the CSV roster export — each step with a ready-to-copy prompt. There's also a fallback so you can build the whole thing today even with no integration to your existing fleet or HR system.

The governance it includes (this is the point)

This is real safety-and-compliance tooling, so it ships with the controls a fleet operation needs: login so only your team can use it, row-level security so you only ever see your own organization's drivers, secure file Storage so license scans aren't sitting in a public folder, a complete audit trail of who reviewed and approved which driver and when, a hard human-approval gate so no one is marked Eligible until your safety manager has reviewed their documents and signed off, and duplicate guards keyed on license number so the same driver can't be entered twice. When eligibility lapses, the status flips to Not-eligible automatically and re-approval is required — the system never quietly leaves an expired driver marked good.

Who it's for

Fleet managers, safety and compliance officers, HR-ops teams, and dispatchers who are responsible for who is allowed to drive — and who are tired of trusting a color-coded spreadsheet to catch an expiring DOT medical card. If you can describe how your operation decides who's cleared to drive, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll see your eligible-driver roster take shape the same afternoon.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.