Shuttle - Real-time Hotel Transport System
Active — Single-repo Next.js + Convex app with role-based dashboards, real-time data sync, and Google Maps integration for hotel shuttle logistics.
Project Details
Project Status: Active Development — Unified Next.js + Convex repository with role-based routing, real-time sync, and Google Maps for hotel shuttle operations.
System Architecture
- Single Repo: Next.js App Router + Convex backend
- Roles: guest, frontdesk, driver, admin, super-admin
- Auth: NextAuth with typed roles (session/JWT extensions)
- UI: shadcn/ui + Tailwind CSS
- Maps: Google Maps SDK for autocomplete, markers, precise coordinates
Real-time Logistics Flow
- Bookings & Verification: Hotel-scoped bookings with seat/bag counts; QR/OTP flows (PENDING → CONFIRMED/REJECTED)
- Live Updates: Dashboards stream via Convex subscriptions for frontdesk/admin
- Driver Scheduling: Trip instances and route segments reflect assignments and occupancy
- Guest Feedback: Live ETA and driver location; click-to-set pickup coordinates
Technical Implementation
- Convex Subscriptions: Immediate sync for bookings, trips, chat, notifications
- Chat: Group and personal chat tied to bookings/participants
- Maps UX: Autocomplete, markers with custom icons, coordinate feedback
- Dashboards: Role-based navigation and stateful views
- Scheduling: Trips, times, route segments, and instances management
Advanced System Features
- Capacity & Resources: Shuttle/driver assignment via trip instances; segment occupancy tracking
- Multi-hotel Support: Scoped entities by hotel
- Security: Role-aware sessions/JWT, tokenized QR verification, OTP throttling
- Deployment: Vercel-ready Next.js frontend + Convex backend
Business Impact
Real-time, role-specific workflows that streamline hotel shuttle logistics, reduce operational overhead, and improve guest transparency.
Tags
Key Features
- Single-repo Next.js + Convex architecture
- Real-time Convex subscriptions for bookings and trips
- Google Maps autocomplete and precise location picker
- Driver tracking with periodic updates and markers
- QR tokens and OTP verification flows
- Seat capacity and route segment occupancy
- Integrated chat tied to bookings and groups
- Role-based dashboards for all user types
- Indexed data tables for performant queries
- Cloud-ready deployment (Vercel + Convex)