Waitlist referral codes and queue position

This article contains affiliate links. If you buy through them, Designyff may earn a commission at no extra cost to you.

The Waitlist / Launch Kit stores each signup like this:

model Signup {
  email      String   @unique
  refCode    String   @unique
  referredBy String?
  createdAt  DateTime @default(now())
}

refCode is randomBytes(4) hex, so it is short and unique. referredBy stores another signup’s code when the visitor arrived with one. It does not store a user id.

Position is the count of signups whose createdAt is earlier, plus one. The first person is position 1. The kit’s count sentence is the stored number plus the word “people”, including when the count is 1.

Settings.launched is a single boolean row. It does not email the list by itself. Export stays in the small admin; to send the launch email, import that CSV into an email tool such as Kit and map refCode to a custom field so you can segment the people who referred others. The flow is also written up in building a waitlist with referrals in Next.js.