NightRide - Peer Rideshare Matcher for Post-Midnight Commuters

Acceptance Criteria

Direction Matching: done when two users with overlapping Mapbox route vectors are surfaced within 60 seconds of both being active. Payment: done when Stripe Connect split charge succeeds and both users receive email receipts. Identity Verification: done when Twilio OTP confirms phone number and Persona selfie check returns verified status before first ride. Rating: done when post-ride 5-star prompt appears and score saves to Postgres within 10 minutes of ride completion.

How to build it, step by step

1. Scaffold project: run 'npx create-next-app@latest nightride --typescript --tailwind --app' then 'npm install @supabase/supabase-js @supabase/auth-helpers-nextjs mapbox-gl stripe @stripe/stripe-js twilio resend'. 2. Create Supabase project at supabase.com, then run SQL migrations to create four tables: users (id, phone, verified_at, stripe_account_id), ride_requests (id, user_id, origin_lat, origin_lng, dest_lat, dest_lng, direction_vector, status, created_at), rides (id, driver_request_id, status, pickup_time), payments (id, ride_id, rider_user_id, stripe_payment_intent_id, amount_pence, platform_fee_pence). Enable RLS and write policies so users can only read their own ride_requests and rides they are matched to. 3. Build direction vector logic in lib/mapbox.ts: call Mapbox Directions API with origin and destination, extract the first waypoint bearing using turf.js bearing(), store as a float in direction_vector. Write a Supabase RPC function match_riders(user_request_id uuid) that queries ride_requests where ST_Distance is under 2km and ABS(direction_vector - target_vector) < 30 degrees and status = 'waiting', ordered by created_at. 4. Build pages/match.tsx: on mount, insert a ride_request row with the user's origin/destination and computed direction_vector, then subscribe to a Supabase Realtime channel on ride_requests filtered by status='matched' AND (driver_request_id = user_id OR rider_request_id = user_id). Render matched RiderCard components. Poll the match_riders RPC every 15 seconds as fallback. 5. Build Stripe Connect driver onboarding: in api/stripe/onboard.ts call stripe.accountLinks.create({ type: 'account_onboarding', account: stripeAccountId }) and redirect driver to the link. Store returned stripe_account_id on the user row. Block ride acceptance if stripe_account_id is null. 6. Build split payment capture in api/payment/create.ts: call stripe.paymentIntents.create({ amount: farePence, currency: 'gbp', application_fee_amount: Math.round(farePence * 0.15), transfer_data: { destination: driverStripeAccountId } }). Confirm on client using stripe.confirmCardPayment. Update payment row with stripe_payment_intent_id on success. 7. Add Twilio SMS OTP in api/auth/send-otp.ts: call twilio.verify.v2.services(TWILIO_SERVICE_SID).verifications.create({ to: phone, channel: 'sms' }). In api/auth/verify-otp.ts call verificationChecks.create({ to: phone, code: otp }) and on approved status set verified_at on the user row and issue a Supabase session via supabase.auth.admin.createUser. 8. Build components/RiderCard.tsx to display: masked first name, direction overlap percentage (computed as 100 - (angle_diff / 30 * 100)), distance from user in metres from Mapbox response, and a green 'Verified' badge if verified_at is not null. Show a 'Join Ride' button that triggers the Stripe payment flow. 9. Build the post-ride rating flow: after ride status is set to 'completed' via a Supabase update, show a modal in pages/match.tsx with a 5-star selector. On submit, insert into a ratings table (id, ride_id, rater_user_id, ratee_user_id, stars, created_at). Display average star rating on RiderCard. 10. Wire up Resend in api/email/receipt.ts: on payment confirmed webhook from Stripe (api/webhooks/stripe.ts, verify with stripe.webhooks.constructEvent), send a receipt email via resend.emails.send({ from: 'receipts@nightride.app', to: user.email, subject: 'Your NightRide receipt', html: receiptTemplate }). 11. Deploy to Vercel: set all env vars (NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, NEXT_PUBLIC_MAPBOX_TOKEN, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_SERVICE_SID, RESEND_API_KEY). Run a full end-to-end test: two browser sessions, both submit ride_requests, confirm match surfaces within 60 seconds, complete Stripe payment, verify email receipt arrives, submit ratings.