Buyer Handoff Guide
BookGuard AI — Handoff Guide
This document provides a complete overview of the BookGuard AI codebase, architecture, and setup instructions for a smooth transition.
Project Overview
BookGuard AI is a check-in/checkout copilot for short-term rental hosts and property managers.
It documents everything, automates damage claims, and protects rental revenue across Airbnb, VRBO, and Booking.com.
Core Features
- Pre-Check-in Documentation — Digital agreements signed before key handoff
- Automated Checkout Inspection — Timed prompts and photo upload portal
- Damage Claim Generator — Package evidence for Airbnb Resolution Center
- Guest Risk Scoring — Low/medium/high risk classification per booking
- Photo Evidence Packaging — Before/after pairs with timestamps
- Multi-Platform — Airbnb, VRBO, Booking.com
Routes
- / — Landing page (hero, how it works, features, CTA)
- /login — Login with demo bypass
- /dashboard — Full demo dashboard with sidebar nav
- /dashboard?demo=true — Demo mode (no auth required)
- /handoff — This buyer handoff guide
Tech Stack
- Next.js 16 (App Router, bundler module resolution)
- TypeScript 5
- Tailwind CSS v4 (@import tailwindcss, @theme inline)
- Supabase (auth + database, env-based configuration)
- Lucide React (icons)
- clsx + tailwind-merge (class utilities)
- Twilio (SMS/WhatsApp notifications — future)
Environment Variables
Copy .env.example to .env.local and fill in your Supabase project details:
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
NEXT_PUBLIC_SITE_URL=http://localhost:3000
TWILIO_ACCOUNT_SID=your-twilio-sid
TWILIO_AUTH_TOKEN=your-twilio-token
TWILIO_PHONE_NUMBER=+1234567890Dashboard Demo Data
15 sample bookings across 5 properties (Oceanview Villa, Downtown Loft, Mountain Cabin, Lakeside Retreat, City Penthouse).
Risk levels: low (7), medium (4), high (4). Statuses: active (10), checking_out (2), completed (2), disputed (1).
Architecture Notes
- Auth context wraps the app via AuthProvider in root layout
- Middleware allows public routes + ?demo=true bypass for development
- Components use Tailwind v4 @theme inline for theme variables
- Dark theme forced via #0c0c0e background regardless of system preference
- Supabase client created via @supabase/ssr createBrowserClient