ClaimMatch

ClaimMatch is a free claim assistant for class-action settlements. People find settlements that are open for claims, check whether they qualify on the official notice, file on the official administrator's site themselves, and keep track of their claims in ClaimMatch.

• ClaimMatch never files or submits a claim for anyone and never handles settlement money. Not taking a cut is an internal position under review, not a public promise; monetization undecided (D4).
• A claim reads "Submitted" only with the administrator's confirmation number. Before that it reads "Not filed yet" or "Reported filed by you".
• Settlement listings come from SettleSignal (CC BY 4.0) and are labeled "Unverified: check the official site" until each record is verified.
• Copy-ready claim details (the user's saved name, email, phone, address and state, ready to copy into the official form) are offered in every state. The user still reviews and submits the claim.
• Filing as the user's agent may come only in a later phase, with counsel review and written permission from each settlement administrator.

See docs/ROADMAP.md for what comes next. Production apply order for the trust-reset migrations is in docs/PRODUCTION-RUNBOOK.md.

---

Tech stack

• Next.js 15 (App Router, React 19, TypeScript): the front end and the Node.js route handlers in one deployable unit.
• Supabase: Postgres, Auth and Row Level Security.
• Tailwind CSS: design tokens in tailwind.config.ts and src/app/globals.css.
• Resend: email.
• Vercel: hosting, Web Analytics and Cron.
• PostHog: product analytics.

---

Getting started (local)

npm install
cp .env.example .env.local     # fill in Supabase + Resend values
npm run dev                    # http://localhost:3000
npm run test:run               # vitest

Auth, the catalog and email need Supabase and Resend keys.

Wire up Supabase

1. Create a project at supabase.com.
2. Apply supabase/migrations/* in order (supabase db push, or paste each file into the SQL editor). scripts/db-test.sh applies them all to a throwaway local Postgres.
3. Sample data is fictional and for a local or staging database only: CLAIMMATCH_ENV=local npm run seed loads sample settlements the local site shows, and supabase/seed.dev.sql (opt-in, see its header) recreates the 16 made-up rows production once showed. npm run seed and npm run scrape refuse to run unless CLAIMMATCH_ENV is local or staging, and always refuse the production project.
4. Copy the project URL, anon key and service role key into .env.local.
5. Make yourself an admin: set [email protected], or run update public.profiles set is_admin = true where email = '[email protected]'; after you sign up.

Environment variables

See .env.example. Summary:

Var	Purpose
NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY	Client and server Supabase access
SUPABASE_SERVICE_ROLE_KEY	Server-only jobs and writes, including every claim update and unsubscribe. Never exposed to the browser
NEXT_PUBLIC_SITE_URL	Canonical URL for metadata, emails and referral links
RESEND_API_KEY / RESEND_FROM	Email
ANTHROPIC_API_KEY	Not used in Phase 0 (the ingest makes no model calls)
ADMIN_EMAILS	Comma-separated allowlist that bootstraps admin access
CRON_SECRET	Protects /api/cron/* (Vercel Cron sends it automatically)
NEXT_PUBLIC_POSTHOG_KEY / NEXT_PUBLIC_POSTHOG_HOST	Product analytics
NEXT_PUBLIC_CONTACT_EMAIL	Inbox for privacy and data requests, shown on Privacy, Terms, the footer and Settings. Set it only to an address that receives mail. Required in Production: a production build (VERCEL_ENV=production) stops without a working address
NEXT_PUBLIC_LEGAL_ENTITY	Legal name of the business that runs ClaimMatch
NEXT_PUBLIC_POSTAL_ADDRESS	Mailing address for the legal pages and footer (\n for line breaks)
MATCH_EMAILS_ENABLED / DIGEST_ENABLED / ADMIN_RECOVERIES_ENABLED / ENABLE_SAMPLE_SOURCE / ASSISTED_FILING_ENABLED / DIRECT_FILING_ENABLED / MATCH_METRICS_ENABLED / ELIGIBILITY_DRAFTS_ENABLED / INGEST_ALERT_EMAILS_ENABLED / LINK_CHECK_ENABLED / PAYOUT_REPORT_ENABLED / FEE_DISCLOSURE_ENABLED / INGEST_MISSING_CLOSE_QUEUE_ENABLED / LAWSUITS_PAGINATION_ENABLED / ADMIN_HELD_CLOSURES_ENABLED / HELD_CLOSURE_TRIAGE_ENABLED / HELD_AUTO_CLOSE_PAST_DEADLINE / DEADLINE_REMINDERS_ENABLED / ONBOARDING_DRIP_ENABLED / / / / / / / / / / / / / / / / / / / / /

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