runbookify
← All plans
Logistics & Transportation / Delivery Scheduling & Proof of Delivery

Delivery Appointment Scheduler: Lock Every Window Before the Truck Rolls

Propose delivery slots, confirm them with the receiver, and lock an appointment of record a person signs off on — so missed windows and redelivery fees stop.

IntermediateA weekendBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you import shipments that need appointments, it proposes valid time slots inside each site's receiving hours and around blackout dates, you confirm a slot with the receiver and approve it, and it locks the appointment of record, captures the confirmation number, sends confirmations, and fires reminder emails — plus a clean appointment-export 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 CSV of shipments needing appointments, your receiver contacts, and receiving hours / available slots
  • Claude Code or any AI coding agent

The problem this kills

A trailer shows up at a dock with no appointment, and it waits — or gets turned away. A coordinator books a window in their head, emails the receiver, and then can't remember whether it was confirmed. Two shipments get promised the same slot. A delivery is set for a day the site doesn't receive, or during a blackout week nobody flagged. The confirmation number lives in someone's inbox, not anywhere the dispatcher can find it at 6 a.m. Every one of these turns into a missed window, a detention charge, or a redelivery fee — and a receiver who trusts your team a little less each time.

The maddening part is that none of it is hard to prevent. You just need one place that knows each site's receiving hours and blackout dates, proposes only valid slots, makes a human confirm the window with the receiver, and then locks that window as the single appointment of record — with the confirmation number attached and reminders that go out on their own. You do not need to be a developer to build that.

What you'll build

A simple internal web tool for your delivery coordinators and dispatch team. You import the shipments that need an appointment, your receiver contacts, and each site's receiving hours and available slots (with blackout dates). The tool proposes valid time windows — never outside receiving hours, never on a blackout date, never a slot already taken. The coordinator picks a proposal, confirms it with the receiver, and approves it. Only then does the tool lock the appointment of record, capture the appointment / confirmation number, send confirmation emails to the receiver and the carrier, and schedule reminder emails before the window. At the end you can export a clean appointments CSV in the exact columns your TMS or carrier portal 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 appointments get booked today and who does it, the systems and spreadsheets you use, the real fields in your shipment and contact data, how your receiving hours and blackout dates are defined, your typical and peak volumes, and the messy edge cases (multi-stop loads, dock capacity, time zones, appointment-by-portal-only sites). It reads a short spec back to you for a thumbs-up, then builds the tool around your answers instead of a generic template. From there it walks the agent through the data model, the CSV imports, the slot-proposal engine, the confirm-and-approve screen, the human approval gate that locks the appointment, the confirmations and reminders, and the appointment export. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a real operation needs: login so only your team can use it, row-level security so people only see their own organization's shipments and sites, a complete audit trail of every proposal, confirmation, approval, and change (who, what, when, and why), a hard human-approval gate so no window becomes the appointment of record until a coordinator confirms it with the receiver and signs off, and duplicate guards — keyed on shipment ID plus appointment date — so the same shipment can't be double-booked or processed twice. The whole tool exists to make a careful human decision easy: the AI proposes the slot, a person locks it in.

Who it's for

Delivery coordinators, dispatchers, and transportation leads who own the calendar of inbound and outbound appointments and are tired of detention, redelivery, and "wait, was that confirmed?" If you can describe how your sites receive freight, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be locking your first real appointment this weekend.

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.