TrueVsAd

The true price of your holiday, not the advertised one.

TrueVsAd shows the true all-in price for a family's exact party next to the advertised headline — bags, seats, tourist taxes, entry documents, getting to the airport, and card/FX fees. UK-focused. Primary domain: truevsad.co.uk.

First feature: Deal X-ray — paste a deal (link, text or screenshot), confirm the details, get the true price and an itemised Receipt.

Ground rules (non-negotiable)

Rule	What it means in code
Click-out only	We never take payment for flights or stays. No checkout, no card fields.
UK data stays in London	Supabase project in London (eu-west-2); Vercel functions pinned to lhr1.
No server-side scraping	The server never fetches airline/OTA pages. Links are stored as references only.
Commission-blind ranking	No commission or affiliate data in the engine or any table used for ranking.
Data minimisation	Child ages (not DOBs), no traveller names. The outward postcode (e.g. SE11) is used at pricing time only and never stored with a receipt; statistics keep only its letters (SE).

The engine

TrueCost = supplier lines + party extras + levies + entry docs + door-to-door + payment/FX
Gap      = TrueCost − advertised headline (whole party)

Every result returns: advertised → true, gap, itemised Receipt, confidence score (0–1). All money is integer pence. The engine (packages/true-cost) is a pure function: no network, no database.

Repo layout

apps/web               Next.js (App Router) — /xray, /fairfam, /school-window, /visit, /r/[slug], /api/xray
packages/true-cost     Shared TypeScript engine: calculateTrueCost()
supabase/migrations    Postgres + PostGIS schema with Row Level Security

Run it locally

You need Node 22 and pnpm (corepack enable gives you pnpm).

pnpm install
cp .env.example apps/web/.env.local   # then fill in your own values
pnpm dev                              # http://localhost:3000/xray

Other commands:

pnpm typecheck   # TypeScript across all packages
pnpm test        # engine unit tests

Database

Production project: truevsad (London, eu-west-2). Quotes are written only by the server through the save_quote() function, which the browser cannot call. Shared receipts never show the postcode, child ages or the deal link.

Create the Supabase project in London, then apply migrations with the Supabase CLI:

supabase link --project-ref <your-ref>
supabase db push

This is the beginning of the README. Read the rest at the original. Read the full README ↗