People sign in with Google, pick a plan, and pay on Stripe. Your app asks which plan a person has before it opens a feature.
For a builder who sells a web app by the month.
Start the subscription app starter blueprint on Typestate
Asked you for your website's address and the address your emails come from.
Started Subscription app starter: 1 record types, 4 web endpoints.
8 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
A person whose payment failed keeps their plan until Stripe ends it, so a card that fails once does not lock them out.
It lives in the action Read My Plan. 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's account, with their plan and where their payments stand.
A person reads only their own account. Only Stripe's events change a plan.
Open an action to read its steps: each sentence, with the calls that do it under it.
From the webPOST /account
Nothing. It needs no input.
Count the Accounts whose person_id is the signed-in person.When there is one, refuse with "You already have an account".
accounts is
Count Accounts where
person_id is caller.id
When accounts is more than 0
Refuse "You already have an account"
Create an Account with person_id set to the signed-in person, email set to the address the person signed in with, plan set to Free, and state set to free.
Add an Account
set email to caller.email
set person_id to caller.id
set plan to "Free"
set state to "free"
Answer with that Account's plan and state.
Answer
plan is account.plan
state is account.state
From the webPOST /plan
Planone of Basic, Pro, needed
Find the Account whose person_id is the signed-in person.When none matches, refuse with "Sign up first".
account is
Find the first Account where
person_id is caller.id
when none refuse "Sign up first"
When that Account's state is active or late, refuse with "You already have a plan. Change it on the billing page".
When account.state is one of "active" or "late"
Refuse "You already have a plan. Change it on the billing page"
When the chosen plan is Basic, open a payment page for the Basic product, with the signed-in person's id as the reference, and answer with its address.When the chosen plan is Pro, open a payment page for the Pro product, with the signed-in person's id as the reference, and answer with its address.
By the given plan:
When it is "Basic":
Opens a payment page for the product Basic, with the reference the id of the person this run is for, as basic page.
Stops and answers with url = the basic page's url.
When it is "Pro":
Opens a payment page for the product Pro, with the reference the id of the person this run is for, as pro page.
Stops and answers with url = the pro page's url.
Producttext, needed
Subscriptiontext, needed
Statustext, needed
A plan started or changed.It reads the product, the subscription and its status, and it runs as the person who pays, who is the signed-in person.Find the Account whose person_id is the signed-in person.When none matches, stop.
account is
Find the first Account where
person_id is caller.id
when none carry on without one
When account holds no value
Answer
Change that Account's plan to the product, its subscription_id to the given subscription, and its state to active when the status is active, or to late for any other status.
Change the Account where
id is account.id
set plan to input.product
set state to "active" when the given status is "active", otherwise "late"
set subscription_id to input.subscription
Nothing. It needs no input.
A plan ended.It runs as the person who paid, who is the signed-in person.Find the Account whose person_id is the signed-in person.When none matches, stop.
account is
Find the first Account where
person_id is caller.id
when none carry on without one
When account holds no value
Answer
Change that Account's plan to Free and its state to ended.
Change the Account where
id is account.id
set plan to "Free"
set state to "ended"
Nothing. It needs no input.
When a payment fails, find the Account of the person who pays, whose person_id is the signed-in person.When none matches, stop.
account is
Find the first Account where
person_id is caller.id
when none carry on without one
When account holds no value
Answer
Change that Account's state to late.
The plan stays, because Stripe tries the card again before it ends the plan.
Change the Account where
id is account.id
set state to "late"
Email that Account's address with the subject "Your payment did not go through", naming its plan and the link to the billing page of the app.
Send an email
to account.email
template "Warn of a Failed Payment Email"
link the setting SITE_ADDRESS
plan account.plan
Nothing. It needs no input.
A free trial ends in 3 days.It runs as the person who pays, who is the signed-in person.Find the Account whose person_id is the signed-in person.When none matches, stop.
account is
Find the first Account where
person_id is caller.id
when none carry on without one
When account holds no value
Answer
Email that Account's address with the subject "Your free trial ends in 3 days", naming its plan and the link to the billing page of the app.
Send an email
to account.email
template "Warn of a Trial Ending Email"
link the setting SITE_ADDRESS
plan account.plan
From the webGET /plan
Nothing. It needs no input.
Find the Account whose person_id is the signed-in person.When none matches, refuse with "Sign up first".
account is
Find the first Account where
person_id is caller.id
when none refuse "Sign up first"
Answer with that Account's plan and state, and paid set to yes when the state is active or late.
A person whose payment failed keeps their plan until Stripe ends it, so a card that fails once does not lock them out.
Answer
paid is
account.state is one of "active" or "late"
plan is account.plan
state is account.state
From the webPOST /billing
Nothing. It needs no input.
Find the Account whose person_id is the signed-in person.When none matches, refuse with "Sign up first".
account is
Find the first Account where
person_id is caller.id
when none refuse "Sign up first"
When that Account's state is free, refuse with "Pick a plan first".
When account.state is "free"
Refuse "Pick a plan first"
Open the Stripe billing page of the signed-in person, and answer with its address.
Opens the billing portal of the person this run is for, as billing.
Answer
url is billing.url
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 |
|---|---|---|
| A signed-in person opens an account. | a signed-in person | POST /account |
| A person picks a plan. | a signed-in person | POST /plan |
| Your app reads the person's plan. | a signed-in person | GET /plan |
| A person opens the billing page. | a signed-in person | POST /billing |
Typestate 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. Taking real money on Live needs a paid plan.
Start the subscription app starter 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 actionsPeople join a waiting list from your page, and each friend they bring moves them up.
4 actions