runbookify
← All plans
Logistics & Transportation / Freight Claims & OS&D

Damage Documentation Intake: Turn Scattered Phone Photos Into Claim-Ready Evidence

Give drivers and receivers a phone-friendly way to capture damage photos, packaging condition, item, value, and location — tagged to the shipment — so claims gets one organized, approved evidence package instead of a text thread full of blurry pictures.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where a driver or receiver captures damage photos, packaging condition, item, declared value, and location tagged to a shipment; claims reviews the evidence, confirms a minimum photo set is present, and approves it as claim-ready; and the locked evidence package is linked to the claim with a clean CSV export for your TMS or claims system.

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 phone or tablet that can take photos
  • A list (or CSV) of your active shipment / PRO numbers
  • Claude Code or any AI coding agent

The problem this kills

A shipment shows up damaged. The receiver pulls out their phone, snaps a few pictures, maybe texts them to a dispatcher, maybe emails them, maybe they just sit in a camera roll. The item, the declared value, the dock door, the condition of the packaging — all of that lives in someone's memory or a hand-scrawled note on the bill of lading.

Then, weeks later, claims tries to file. The photos are blurry, half of them are missing, nobody wrote down which shipment they belonged to, and the carrier denies the claim because the evidence is incomplete. Money walks out the door because the documentation was scattered across phones, texts, and inboxes instead of captured cleanly at the moment of damage.

You don't need a six-figure claims platform to fix this, and you don't need to be a developer. You need a simple, phone-friendly intake tool that forces a complete, organized evidence package every time — and you can build it this afternoon.

What you'll build

A simple internal web tool that works great on a phone. A driver or receiver opens it at the dock, picks the shipment (PRO / BOL / load number), and captures everything in one flow: damage photos (with a required minimum set — overview, close-up, packaging, and a label shot), the packaging condition, the item and how many units, the declared value, and the location where the damage was found. The tool stores the photos safely in file storage and ties every piece of evidence to the shipment.

Claims then opens a clean evidence queue, reviews each package, confirms the minimum photos and packaging evidence are present, and clicks Approve — claim-ready. Only approved packages get locked and linked to a claim, and the tool produces a tidy CSV (and a downloadable evidence bundle) in the exact columns your TMS or claims system expects.

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 damage gets caught and reported today, what you call your shipment numbers (PRO, BOL, load, container), the exact packaging conditions and damage types you track, how you record item and declared value, what your minimum photo set should be, your typical and peak damage volumes, and your messy edge cases (concealed damage found days later, partial damage, refused freight) — and then it tailors the data model, the required-photo rules, and every later step to your answers. This is not a generic template; the agent reads a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through the capture flow, the file storage, the photo-set and packaging-evidence validations, the claims review-and-approve queue, the claim linking, and the CSV/evidence export — each step with a ready-to-copy prompt. There's also a fallback so you can build and use the whole thing today with no integration to your existing system.

The governance it includes (this is the point)

This is real claims tooling, so it ships with the controls a logistics team needs: login so only your drivers, receivers, and claims staff can use it, row-level security so each location or business unit only ever sees its own shipments and evidence, a complete audit trail of who captured, reviewed, and approved each package and when, a hard human-approval gate so no evidence package is marked claim-ready or attached to a claim until claims signs off, and duplicate guards keyed on shipment + item so the same damaged item can't be logged twice. Approved packages are locked so the evidence can't be quietly changed after the fact.

Who it's for

Drivers and receivers who catch the damage, and the claims and OS&D (Over, Short & Damaged) folks who have to prove it to a carrier. If you can describe how a damaged shipment gets reported at your dock today, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll have a working damage-intake screen on your phone 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.