Skip to main content

Referral Program

Every user has a unique referral code and shareable link. When a new user signs up with someone's code, that referrer is recorded, and both sides can earn a coin bonus. The bonus amounts are admin-configurable and default to 0 (the program is inert until an admin turns it on).

Each property has its own checkbox marking whether that specific piece is fully implemented and functional end to end (frontend + backend) — update these yourself as work lands; this page won't overwrite them.

  • Each user gets a unique referral code + shareable link (Settings → Refer & earn), with quick-share buttons for WhatsApp, Facebook, X, and the device's native share sheet
  • New users can sign up with a referral code (captured from a ?ref=CODE link on the signup form)
  • The referrer is recorded on the new account (once, at signup)
  • Both sides earn a configurable coin bonus at signup (referrer bonus + new-user welcome bonus)
  • The referrer gets a notification when they earn a referral bonus
  • Referral stats: how many people you've referred and how many coins you've earned
  • Admin can set the two bonus amounts (Admin → Payments → Settings)
  • Running affiliate commission on a referred user's purchases (not just a one-time signup bonus) — not built; would be a separate hook into the purchase flows
  • Referral leaderboards / tiers — not built

See the technical reference for GraphQL schemas, routes, source file links, and per-field wiring status.