TaxiCard
A digital taxi card and private booking system for independent drivers.
Each driver gets a public card at /{slug}, a QR code, their own customer
list, and a dashboard. No marketplace, no dispatch.
Upload
Upload everything in this folder to GitHub, keeping the structure. There
is no public folder — icons, the manifest and the service worker are all
generated from code in src/app, so nothing binary needs uploading.
SQL — run in the Supabase SQL editor, in order
| File | What it does | Needed |
|---|
0001_init.sql | Tables, RLS, booking functions | Yes |
0002_storage.sql | driver-media bucket for photos | Yes |
0003_push.sql | Push subscriptions | For notifications |
0004_card_whatsapp_fallback.sql | WhatsApp falls back to main number | Yes |
0005_make_admin.sql | Makes you an admin (edit the email first) | Optional |
0006_realtime.sql | Live ringing alert | Optional |
0007_eircode.sql | Eircode + pickup coordinates | Yes |
Safe to re-run. "Already exists" errors mean it ran before.
Environment variables in Vercel (Production)
NEXT_PUBLIC_SUPABASE_URL https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY sb_publishable_…
NEXT_PUBLIC_SITE_URL https://taxicard.ie (no trailing slash)
SUPABASE_SERVICE_ROLE_KEY sb_secret_… (sensitive)
NEXT_PUBLIC_VAPID_PUBLIC_KEY B…
VAPID_PRIVATE_KEY … (sensitive)
PUSH_CONTACT_EMAIL [email protected]
GOOGLE_MAPS_SERVER_KEY optional, names streets for "use my location"
Variables only apply to new builds. After editing one, redeploy.
What is built
Driver: signup, login, password reset, profile with a unique link,
card preview, photo upload, QR download, availability toggle, dashboard
with live counts, accept and decline, bookings list, customer list with
call and WhatsApp, search, manual add, private notes, booking history.
Passenger: public card at /{slug} with call, WhatsApp and book.
Booking form with "use my current location" and optional Eircode. A status
page at /b/{token} that updates itself.
Alerts: web push once installed to the home screen, plus a full-screen
ringing alert when a booking arrives with the app open.
Admin at /admin: platform counts, driver list, disable and re-enable,
plan flags. Deliberately shows counts, not other drivers' customers.
Known gaps
- No driver licence verification. Anyone can sign up.
- No email alerts. Push only.
- No address autocomplete. Typed addresses plus optional Eircode.
- Changing a slug breaks printed QR codes. No warning yet.
- GDPR: privacy policy and a customer data deletion route still to do.
