People join a waiting list from your page, and each friend they bring moves them up.
For a maker who collects email addresses before a launch.
Start the launch waitlist with referrals blueprint on Typestate
Asked you for your website's address and the address your emails come from.
Started Launch waitlist with referrals: 1 record types, 4 web endpoints.
4 actions are compiling.
Deployed to Sandbox. Try it at your Sandbox address.
Each step has 3 parts: who starts it, how it reaches your backend, and the action that answers.
The rule you will want to change first
Each person who joins through your link moves you 5 places up the list.
It lives in the action Join the Waitlist. Tell your agent how you want it instead: one sentence changes, and you read the change before it goes Live.
The map shows the records it keeps, the actions it runs and the services it calls.
What it keeps
What it does
What it reaches
One person on the list, with their place and the friends they brought.
Anyone can read and write it.
Open an action to read its steps: each sentence, with the calls that do it under it.
From the webPOST /waitlist
EmailEmail, needed
Nametext, optional
Referral codetext, optional
Find the Signup whose email is the given email address.When one matches, refuse with "This address is already on the list".
same_email is
Count Signups where
email is input.email
When same_email is more than 0
Refuse "This address is already on the list"
Make a new referral code of 8 random letters and digits.
code is a random code of 8 letters and digits
The person's number is the count of Signups plus one.
signups is
Count all Signups
place is signups + 1
When a referral code was given, find the Signup whose referral_code is that code.When one matches, add 1 to that Signup's friends and take 5 off its score.A code that matches nobody is ignored, and the person still joins.
A friend's code moves its owner up, because a person who brings friends is worth more at launch.
When input.referral_code is given
referrer is
Find the first Signup where
referral_code is input.referral_code
when none carry on without one
When referrer holds a value
Change the Signup where
id is referrer.id
set friends to referrer.friends + 1
set score to referrer.score - 5
Create a Signup with email and name set to the given email address and name, referral_code set to the new code, referred_by set to the given referral code, friends set to 0, number and score set to the person's number, and state set to waiting.
Add a Signup
set email to input.email
set friends to 0
set name to input.name
set number to place
set referral_code to code
set referred_by to input.referral_code
set score to place
set state to "waiting"
Email the given address with the subject "You are on the list", saying their place and their own link, which is the site address with ?ref= and their referral code on the end.
Send an email
to input.email
template "Join the Waitlist Email"
place place as a number
referral_code signup.referral_code
value the setting SITE_ADDRESS
Answer with the person's number as the place, and the new referral code.
Answer
place is place
referral_code is code
From the webGET /waitlist/place
Referral codetext, needed
Find the Signup whose referral_code is the given referral code.When none matches, refuse with "No place matches this link".
signup is
Find the first Signup where
referral_code is input.referral_code
when none refuse "No place matches this link"
When that Signup's state is invited, answer that they are invited.
When signup.state is "invited"
Answer
invited is true
Otherwise their place is the count of Signups whose state is waiting and whose score is lower than that Signup's score, plus one.When two scores are the same, the Signup with the lower number, who joined first, is ahead.
lower_scores is
Count Signups where
score is less than signup.score
state is "waiting"
earlier_same_score is
Count Signups where
number is less than signup.number
score is signup.score
state is "waiting"
place is (lower_scores + earlier_same_score) + 1
Answer with the place, that Signup's friends, and the count of Signups whose state is waiting.
waiting is
Count Signups where
state is "waiting"
Answer
friends is signup.friends
invited is false
place is place
waiting is waiting
From the webPOST /waitlist/invite
Numbera whole number, needed
When the given number is less than 1 or more than 50, refuse with "Invite between 1 and 50 people at a time".
When input.number is less than 1
or input.number is more than 50
Refuse "Invite between 1 and 50 people at a time"
List that many Signups whose state is waiting, lowest score first.When two scores are the same, the Signup with the lower number, who joined first, goes first.
waiting_people is
Find Signups where
state is "waiting"
sorted by number, lowest first
by_score is waiting_people
sorted by score, lowest first
queue is the first input.number items of by_score
For each of those Signups, change its state to invited, and email its email with the subject "You are in", saying that their access is ready.
For each person in queue, at most 50
Change the Signup where
id is person.id
set state to "invited"
Send an email
to person.email
template "Invite the Next People Email"
Answer with the count of Signups invited now, and the count of Signups whose state is still waiting.
still_waiting is
Count Signups where
state is "waiting"
Answer
invited is the number of the value named queue
waiting is still_waiting
From the webGET /waitlist
Stateone of waiting, invited, optional
List the Signups, newest first.When a state is given, list only the Signups in that state.
all_signups is
Find all Signups
sorted by created_at, highest first
signups is
each signup of all_signups where
input.state is not given
or signup.state is input.state
For each Signup, answer its email, name, state, friends and score.
rows is
each signup of signups as
email is signup.email
friends is signup.friends
name is signup.name
score is signup.score
state is signup.state
Also answer the count of Signups whose state is waiting, and the count whose state is invited.
waiting is
Count Signups where
state is "waiting"
invited is
Count Signups where
state is "invited"
Answer
invited is invited
signups is rows
waiting is waiting
People sign up and sign in with an email address and a password, or with a provider you add, such as Google.
| What it does | Who may call | Address |
|---|---|---|
| Your page posts the form here. | anyone | POST /waitlist |
| Your page shows a person their place. | anyone | GET /waitlist/place |
| Only you, with your key, invite people. | you, with your key | POST /waitlist/invite |
| Only you, with your key, read the list. | you, with your key | GET /waitlist |
3 frontends, each in a different stack, for the same backend. Under each page are the web endpoints it calls and the action that answers each one.
Astro
For visitors
The product's own page. A visitor joins the list and sees their place and their own link.
/ Join
The product, and the form that puts a visitor on the list. A friend's link fills in their code.
POST /waitlistJoin the Waitlist/place Your place
The visitor's place in the queue, how many friends joined through their link, and the link to share.
GET /waitlist/placeShow My PlaceHTML and JavaScript
For visitors of a page you did not build
One script tag puts the form on a page somebody else built, here a baking blog. After the join it shows the place in the same box.
/ Recipe with the form
A recipe post with the form at the end. The form joins, then shows the place and the link to share.
POST /waitlistJoin the WaitlistGET /waitlist/placeShow My PlaceReact with Vite
For you, with your API key
The owner reads the list and invites the next people. The API key stays in the browser tab and is never in the build.
/ The list
Everybody on the list, newest first, with the friends each one brought. Filter by waiting or invited.
GET /waitlistRead the List/invite Invite people
Who is next in the queue, and the button that invites them.
GET /waitlistRead the ListPOST /waitlist/inviteInvite the Next PeopleTypestate is the backend. Paste this brief into Lovable, v0, Claude Code or the tool that builds your pages.
Starting from this blueprint does not count against the action changes of your plan. The Free plan runs it on Sandbox. Live needs a paid plan.
Start the launch waitlist with referrals blueprint on TypestateChoose a planReaders subscribe for free or pay monthly. Paid issues go to paying readers first, and open to everyone after 30 days.
7 actionsEach sale and delivery moves the stock, and the owner gets one email when a product runs low.
5 actionsInvoices get numbers that are never reused, go out by email, and a reminder follows when one is late.
6 actions