SPS Luxury Limo Starter

Starter repository for SPS, a luxury limousine and executive sprinter booking platform based in Las Vegas, Nevada.

This scaffold is intentionally set up so an AI coding agent such as Jules can extend it into a production-ready platform on GitHub + Vercel.

Product direction

Customer-facing

• Browse fleet by category
• Book one-way rides, hourly service, airport transfers, event service, and multi-stop itineraries
• Select vehicle-specific add-ons such as champagne and premium snacks
• Pay a deposit during checkout
• Review booking details from mobile or desktop
• Track the assigned driver live on a map after dispatch

Company / owner-facing

• Review incoming bookings
• Accept or decline bookings
• Assign accepted bookings to drivers
• View driver availability windows
• Send a driver itinerary with trip details, add-ons, pickup/drop-off information, and service notes

Driver-facing

• Mark availability
• See assigned itinerary
• Update status
• Share live location during active trips

Recommended implementation stack

• Framework: Next.js App Router
• Hosting: Vercel
• Language: TypeScript
• Database / Auth / Realtime: Supabase
• Payments: Stripe
• Maps / location: Mapbox
• Notifications: Twilio SendGrid or Resend + Twilio SMS

Why this stack

Next.js App Router, Vercel, Supabase, Stripe, and Mapbox fit this product well because they cover routing, hosting, auth, database, realtime events, payments, and live map visualization without forcing a fragmented architecture.

Included in this starter

• Luxury landing page
• Booking experience mock page
• Customer booking dashboard mock page
• Owner portal mock page
• Shared design system and mock data
• Initial Supabase SQL schema draft
• AI handoff notes and first Jules prompt

Local setup

npm install
npm run dev

Then open http://localhost:3000.

Upload to GitHub

1. Unzip this project locally
2. Create a new GitHub repository
3. Upload the files or push via git
4. Import the repository into Vercel
5. Add environment variables from .env.example
6. Hand the repository to Jules with the first prompt in docs/JULES_PROMPT_01.md

Important business rules to implement

• Bookings can be pending, accepted, declined, assigned, en route, arrived, completed, or cancelled
• Deposits are paid at booking time
• Deposit becomes non-refundable within 24 hours of scheduled service
• Add-ons must be restricted by vehicle type or booking class
• Owners must be able to manually approve/decline bookings
• Drivers can only be assigned when they have matching availability
• Customer live tracking must only activate after the booking is accepted and assigned

Notes

This repo is intentionally a polished scaffold, not a finished production application. The next step is to have Jules implement:

• Supabase auth and role-based access
• real booking persistence
• payment checkout
• realtime driver tracking
• notifications
• admin workflows