Givto: Secret Santa app π π
- Start a Secret Santa and share one link in the group chat; people join with their name and an emailed code (email invites too)
- Sign in with an emailed code or link, or a passkey: no passwords
- Phases from draft to open, drawn, gift day and done: scheduled draws, deadlines, reminders, calendar events
- A fair draw that keeps households and chosen pairs apart, and avoids last year's giftee
- One wishlist for all your groups: prices, links, import from a shop URL, hide wishes per group, Dibs! so nobody buys the same gift
- Tips for someone's Santa, anonymous questions and Psst! nudges between Santa and giftee
- Gift day: unwrap order, presenter view and the big reveal
- Same again next year: groups keep their people, each year is a new edition
- English and Dutch, light and dark mode, made for phones
Needs Node 24, pnpm and Docker (Docker Desktop or Colima).
pnpm install
pnpm dev:local # Mongo and the mail mock in Docker (docker-compose.yml), then next dev on :3000
pnpm seed # (second terminal) wipes the local database (indexes too), adds demo groups, one per phaseSign in at http://localhost:3000 with you@example.test (or the SEED_EMAIL you seeded with).
Mail doesn't leave your machine: codes, links and every other email land in the inbox at
http://localhost:3091.
pnpm cron tickruns the scheduled jobs once (draws, gift day, emails),pnpm cron retentionthe daily cleanup, as Vercel Cron does in production.pnpm testruns the checks;pnpm e2ethe Playwright tests: stopnext devand runpnpm buildfirst (both write.next); e2e starts its own app, Mongo and mail mock, see e2e/README.md.- After pulling,
pnpm seedagain if the app errors on old local data: seeded data is always current, so it counts as migrated (pnpm migrateis for databases from the old app). docker compose downstops the services;docker compose down -valso deletes the database.
Local settings live in .env.development (committed, dev-only values). next dev loads it over .env
and it sets every variable the app reads, so a .env file is not used for local development.
Production secrets live in Vercel only.
OWNER_NAME and OWNER_EMAIL are required at build time (the /privacy contact), so a local
pnpm build needs them in the shell or a .env. OWNER_EMAIL also gets a daily email listing new
groups (name and organizer email) when there are any.