Back to workCase study

Quote & Nod

A maintenance quote approval portal for property managers. The owner gets every vendor quote in one link and answers from their phone, and the decision stays on the job's record.

What it does

Quote & Nod covers one thing: a maintenance job, its vendor quotes, the owner's decision and the paper trail behind it. Rent collection, leases and tenant screening are left out on purpose.

What I built

  • Email and password auth with session refresh and route protection.
  • Properties, with the owner's contact created or updated alongside.
  • Jobs that move through eight statuses, from new to closed, with urgency, scheduling and completion.
  • Quotes per job, with one marked as recommended for the owner.
  • Attachments in private storage, served through short-lived signed links.
  • Comments that can be internal or visible to the owner.
  • A typed activity timeline for every job.
  • A tokenized owner portal to approve, reject or ask a question.
  • Emails for approval requests, confirmations, rejections and completion.
  • A dashboard sorted into four buckets, and a seed script for demos.

Decisions worth a look

  • Owners don't need an account. Owners approve through a link carrying a random 24-byte token with a 30-day expiry; sending it again rotates it. The trade-off against magic links is documented, with an upgrade path to an emailed one-time code.
  • Authorization lives in every action. Each server action verifies the session itself and re-checks that the row belongs to the manager, because route protection is not trusted to authorize.
  • Locked down by default. Row Level Security is on for every table with no policies, so the public API exposes nothing. Storage is private, uploads are capped at 10 MB, and every input is validated on the server.
  • Runs locally end to end. Without an email key the mailer logs instead of sending, and environment variables are validated at start-up, so the whole approval flow works on a laptop.

Data model

Users, owner contacts, properties, maintenance jobs, quotes (amounts in cents), attachments, comments and a typed event stream with JSON metadata. UUID keys, timestamps with time zones, and a unique index on the owner's access token.

Stack

Next.js (App Router) · TypeScript · Supabase (Postgres, Auth, Storage) · Drizzle ORM · React Hook Form + Zod · Radix primitives · Tailwind · Resend