runbookify
← All plans
Field Service & Dispatch / Technician Routing & Mobile Checklists

Pre-Trip Vehicle Inspection (DVIR) Logger

A mobile daily vehicle safety checklist with photos. Any reported defect routes to the fleet lead, who must approve the truck as safe-to-operate or out-of-service before it can be dispatched.

BeginnerAn afternoonBuilds onNext.js (App Router) on VercelSupabase (Postgres, Storage, Auth, RLS)Resend (email alerts)
What you'll build

Drivers run a daily pre-trip inspection from their phone, snap photos, and flag defects. The fleet lead reviews flagged vehicles and marks each one safe-to-operate or out-of-service before dispatch. Every inspection and approval is logged and exportable as CSV for compliance.

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 vehicle list (spreadsheet or CSV is fine)
  • An inspection checklist by vehicle type (spreadsheet or CSV)
  • Free accounts: Vercel, Supabase, Resend
  • No coding experience required

The problem this kills

Every morning your drivers are supposed to walk the truck, check the brakes, lights, tires, and fluids, and write it all down on a paper DVIR (Driver Vehicle Inspection Report) pad. In reality the pad lives in the cab, half the boxes get ticked at the diesel pump, and the one inspection that actually mattered — the cracked brake line — is a smudge on a carbon copy nobody filed.

When a defect does get noted, what happens? Often nothing fast enough. The truck rolls out before anyone with authority decides whether it's safe. And when a regulator, an insurer, or a lawyer asks "show me the inspection history for this vehicle," you're digging through a glovebox or a filing cabinet.

This tool replaces the paper pad with a phone form, forces a real human decision before a flagged truck leaves the yard, and keeps a clean, exportable record of every inspection — who did it, when, what they found, and who signed off.

What you'll build

A small web app your drivers open on their phones:

  • A driver picks their assigned vehicle and runs the day's checklist — the exact items you inspect, grouped by vehicle type (a tractor-trailer asks different questions than a service van).
  • For any item, the driver can mark it OK or defect, add a note, and attach a photo straight from the camera.
  • The moment a defect is reported, the inspection lands in the fleet lead's review queue and the vehicle is held — not yet cleared for dispatch.
  • The fleet lead opens the inspection, sees the photos and notes, and makes the call: safe-to-operate or out-of-service. Nothing changes the vehicle's dispatch status until they do.
  • Open defects stay tracked until someone closes them, so a problem can't quietly disappear.
  • Everything exports to a CSV in the exact columns your compliance system or DOT file expects.

What's inside the Implementation Plan

The plan is a runbook you paste into an AI coding agent (Claude Code), which then builds the app with you step by step. You don't write code — you answer questions and paste prompts.

It starts by interviewing you about your fleet. This is the part that makes the tool yours instead of a generic template. Before it builds anything, the agent asks how your inspections work today, what vehicle types you run, the real checklist items per type, how you name and number vehicles, your typical and peak inspection volumes, exactly who approves a flagged truck, and the messy edge cases (rentals, swapped trailers, the driver who inspects two trucks). Then it reads a short spec back to you and waits for your thumbs-up before writing a single line.

After that, it walks you through standing up the database, the login, the mobile checklist, the photo capture, the fleet lead's review-and-approve gate, the email alerts, and the compliance CSV export — each step ending in a prompt you simply copy and paste.

The governance it includes (this is the point)

This isn't a toy form. The plan builds in the controls that make it trustworthy for a safety-critical process:

  • Login so only your team can use it.
  • Row-level security so each company only ever sees its own vehicles and inspections.
  • A human-in-the-loop approval gate — a reported defect can never auto-clear a vehicle. The fleet lead must review and explicitly mark it safe-to-operate or out-of-service.
  • A complete audit trail — who inspected, what they found, who approved, and the exact timestamps.
  • Duplicate guards — one inspection per vehicle per day, so the same truck can't be logged twice and skew your records.

Who it's for

Drivers and technicians who do the daily walkaround, fleet coordinators who dispatch the trucks, and safety managers who answer to regulators and insurers. If you run anything from a handful of service vans to a yard full of tractors, and you want defensible inspection records without buying a heavyweight fleet platform, this is for you.

You've got this — paste the first prompt and let the agent interview you.

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.