Leadgen: booking platform for detailers

One repo, two Next.js apps, one Supabase project behind both.

Path	Port	What it is
apps/booking	3000	Customer-facing. Serves every tenant's booking pages, chosen by hostname, plus /embed.js. Later: /api/agent, webhooks, the jobs runner. No logins.
apps/admin	3001	Owner dashboard (and later super-admin). Everything behind a login.
packages/core		Shared code: Supabase admin client, tenant lookup, and the booking engine (pricing, availability, holds).
supabase/		Migrations and seed data.

Running locally

npm install
npm run dev          # both apps, behind one address: localhost:3000
npm run dev:booking  # just the booking app, on :3002
npm run dev:admin    # just the admin app, on :3001
npm test             # unit tests for pricing, availability and time zones

Both apps read the root .env.local (see .env.example). The booking app needs SUPABASE_SECRET_KEY.

Addresses on localhost

npm run dev starts a small router on :3000 (routing/dev-router.mjs) in front of the two apps. It applies the same rules as Vercel (routing/rules.mjs, which vercel.json is written from by npm run routing:vercel), so each address reaches the app that serves it. Every link is built by packages/core/src/urls.ts from ROUTING_MODE (see .env.example and info/routing.md).

Path mode (the default, and what the .vercel.app deployment uses):

• http://localhost:3000: the landing page, with the docs at /docs
• http://localhost:3000/app: the owner dashboard (/app/login to sign in)
• http://localhost:3000/admin: the platform admin
• http://localhost:3000/booking/ascnd: ASCND's booking pages
• http://localhost:3000/booking/test-detailing: Test Detailing (different branding and prices, for isolation testing)
• http://localhost:3000/booking/ascnd/embed-test: a stand-in for a detailer's own site, loading the embed script

Subdomain mode (ROUTING_MODE=subdomain and NEXT_PUBLIC_ROUTING_MODE=subdomain; browsers send *.localhost to your machine without any DNS):

• http://localhost:3000: the landing page and docs
• http://app.localhost:3000 and http://admin.localhost:3000: the dashboard and platform admin
• http://ascnd.localhost:3000: ASCND's booking pages

A business's booking pages come from its slug; the domains table only holds domains of their own (booking.theirsite.co.uk), used in subdomain mode once verified.

Database

Apply migrations to the hosted project with the Supabase CLI (npx supabase db push), then run supabase/seed.sql in the SQL Editor.

Booking engine

packages/core/src/booking/engine.ts is the tool layer: getBookingConfig (list_services), quote (get_quote), checkArea, findSlots (check_availability), saveLead, holdSlot and confirmBooking. The plain booking form uses it now; the Booking Agent will call the same functions. Prices only ever come from getQuote() in pricing.ts.

bookings