● Mockup 332 · Invite Journeys

Bringing people into a circle

How a subject invites the three people who can join their circle: a Caregiver, a Supporter, and a Peer. Every message writes itself, so the person sending it never has to explain what Maddy is or why they are asking.

App screens shown in the  Cotton Candy Sky  theme, one of Maddy's 8 sensory themes.
1

How to read this page

Five kinds of surface appear below. Each one is styled to look like the real thing it becomes, so you can trace a single invite from the moment it is composed to the moment someone joins.

In-app screen

A screen inside the Maddy app. Cotton Candy Sky theme, Lexend, large 44px+ targets for the subject.

iMessage bubble

The text the app writes and the sender sends. Blue bubbles are outgoing.

Link-preview card

The rich card that unfurls in the thread when the link is shared. Maddy-branded.

Web landing page

The marketing surface at join.mymaddy.app. Cotton Candy Sky, Baloo 2 + Lexend.

Store page

Where the app installs: TestFlight today, the App Store and Google Play later.

2

The whole invite path

One straight line, sender to joined. The role only changes the words: the shape of the path is the same for Caregiver, Supporter, and Peer.

01
✍️

Sender composes

Subject picks a role in the app.

In-app
02
💬

Message + preview

App writes the text and the code.

iMessage
03
🔗

Preview unfurls

Rich card explains what this is.

Preview
04
🌤️

Landing page

Role-adaptive welcome, big button.

Web
05
📥

Store

TestFlight now, App Store later.

Store
06
📲

Install

Maddy lands on the phone.

Store
07
🔑

Open + code

Enter the invite code.

In-app
08
🤝

Joined

They are in the circle.

In-app
3

Three roles, four surfaces each

For every role: the in-app compose screen, the message the app writes, the preview card that unfurls, and the landing page tuned to that role. Copy is drawn from the app's canonical role definitions.

Caregiver

Inner ring

Helps with the daily stuff. Can see what's going on, leave notes, set tasks and rewards, and check in on things. The circle's plan covers them, no separate charge.

a In-app compose
9:41▪▪▪ 100%
Invite someone

Who are you inviting?

Pick what they'll be in your circle. You can change your mind later.

Invite code
SKY-42F

This code is just for them.

b The message it writes
9:41▪▪▪ 100%
🫶
Aunt Rosa
iMessage
Today 9:41 AM
Hi Rosa. I'm setting up a little circle of support in an app called Maddy, and I'd love you in it as one of my support people. You'd be able to see what I'm working on day to day, leave me notes, and help me keep things going. The plan for the circle covers you, so there's nothing to pay.
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-42f
You're invited to Jordan's circle

Join as a support person. Help with the day to day. Free for you.

Text Message · SMS
c Preview card, up close
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-42f
You're invited to Jordan's circle

Join as a support person: help with the day to day, leave notes, cheer them on. The circle's plan covers you.

One line says what it is, so no one has to ask "what's Maddy?"

d Landing page
🔒 join.mymaddy.app/c/sky-42f
🌤️ You've been invited

You've been invited to Jordan's circle

Maddy is a warm little app that helps someone through their day: gentle check-ins, small tasks, and the people who care about them, all in one place.

🫶 What Caregiver means for you

You're inner-ring. You'll see what they're working on, leave them notes, help set up tasks and rewards, and check in on the day to day. It's support, never surveillance.

The subscription for the circle covers you. You won't be asked to pay anything.

Your invite code
SKY-42F
📲 Get Maddy

Free to download · This code is just for you

Supporter

Outer ring ● Always free

Cheers them on from the sidelines. Sees the wins they choose to share, a finished day, the things they're proud of. Never the day-to-day, never the hard days unless shared.

a In-app compose
9:41▪▪▪ 100%
Invite someone

Who are you inviting?

Pick what they'll be in your circle. You can change your mind later.

Invite code
SKY-7QM

This code is just for them.

b The message it writes
9:41▪▪▪ 100%
📣
Grandma Bev
iMessage
Today 9:41 AM
Hi Grandma! I'm using an app called Maddy that helps me through my days, and I'd love you cheering me on in it. You'd see the wins I choose to share: a good day, something I'm proud of. You won't see the everyday stuff or the hard days, just the good news I send your way. It's free for you, always.
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-7qm
Jordan wants you cheering for them

See the wins they share. Always free.

Text Message · SMS
c Preview card, up close
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-7qm
Jordan wants you cheering for them

You'll see the wins they choose to share. Not the day-to-day, not the hard days. Always free.

Reassurance is built in: shared wins only, always free.

d Landing page
🔒 join.mymaddy.app/c/sky-7qm
🌤️ You've been invited

You've been invited to Jordan's circle

Maddy is a warm little app that helps someone through their day. You're being asked to be one of the people cheering them on.

📣 What Supporter means for you

You're in the outer ring. You'll see the wins they choose to share: a finished day, the things they're proud of. You won't see the day-to-day or their hard days unless they share them.

Always free, and you only ever see what they choose to share with you. Nothing more.

Your invite code
SKY-7QM
📲 Get Maddy

Free to download · This code is just for you

Peer

Outer ring ● Always free

A friend standing alongside. For friendships where you help each other and celebrate together. They see the wins you share, and they may keep their own Maddy circle too.

a In-app compose
9:41▪▪▪ 100%
Invite someone

Who are you inviting?

Pick what they'll be in your circle. You can change your mind later.

Invite code
SKY-9BD

This code is just for them.

b The message it writes
9:41▪▪▪ 100%
🤝
Sam
iMessage
Today 9:41 AM
Hey Sam. I'm on an app called Maddy that helps me through my days, and I'd love you in it as a peer, someone standing alongside me. Peer is for friendships: we help each other and celebrate the wins together. You'll see the wins I share with you, and you can set up your own Maddy circle too if you want one. Free, always.
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-9bd
Jordan wants you standing alongside them

Peer to peer: help each other, celebrate together. Always free.

Text Message · SMS
c Preview card, up close
join.mymaddy.app🌤️ Maddy
join.mymaddy.app/c/sky-9bd
Jordan wants you standing alongside them

Peer is for friendships: help each other, celebrate together. You can keep your own circle too. Always free.

Peer honors that the friend may be AuDHD too, with a circle of their own.

d Landing page
🔒 join.mymaddy.app/c/sky-9bd
🌤️ You've been invited

You've been invited to Jordan's circle

Maddy is a warm little app that helps someone through their day. You're being asked to stand alongside them as a peer.

🤝 What Peer means for you

You're in the outer ring, friend to friend. You'll see the wins they share with you, and you can help each other and celebrate together. If you'd like, you can set up your own Maddy circle too.

Always free. You see only the wins they share with you, and your own circle stays entirely yours.

Your invite code
SKY-9BD
📲 Get Maddy

Free to download · This code is just for you

4

Journey A · TestFlight (today)

This is the path a real invitee walks right now. Maddy isn't on the App Store yet, so getting in means an extra app, a manual code, and a few places where the thread of "why am I doing this" can snap. Every amber marker is a friction point we carry today.

1 The text arrives
9:41SMS
Hey! Join my circle in Maddy, a little app I'm using for daily check-ins and support. Download it here (free): testflight.apple.com/join/Ez1Msh5G Then open the app, tap "I have an invite code", and enter: SKY-42F Code expires in 7 days.
!

Plain SMS, no rich preview. A bare TestFlight link with no Maddy branding around it.

2 Tap the link
9:41Safari
TestFlight

Maddy

To test Maddy, install TestFlight, then tap "Start Testing".

View in TestFlight
Install TestFlight first
!

No landing page today. The link drops straight onto Apple's TestFlight page, losing Jordan's name and the role context.

3 "You need TestFlight"
9:41App Store
🧪
TestFlight
Apple
GET

Beta testing apps requires the TestFlight app from Apple. Install it, then return to your invite link.

!

An extra app to install. Nobody expects to download a second app just to open the first.

4 Install TestFlight
9:41App Store
🧪
TestFlight
Installing…

Then reopen the invite link to redeem it inside TestFlight.

!

Context loss. After the detour to the App Store, they must find the original text again.

5 Install Maddy
9:41TestFlight
🌤️
Maddy
Jeremy Runge
INSTALL

Beta · Build #71. You have a seat in this test.

Install
!

Seat limits. TestFlight caps testers, so an invite can hit "this beta is full" with no graceful fallback.

6 Open Maddy
9:41Maddy
🌤️

Welcome to Maddy

A gentle place for your days.

Get started
I have an invite code
!

No deep link. The app opens cold. It has no idea an invite is waiting, so they must find the right button themselves.

7 Type the code
9:41Maddy

Enter your invite code

It's in the text you were sent.

SKY-42F
Join circle
!

Manual code typing. They have to switch back to Messages, memorize or copy the code, and type it by hand.

8 Joined
9:41Maddy

You've been invited as a support person.

You'll see what Jordan's working on, leave notes, and see the photos they share. The circle's plan covers you.

They made it. The welcome copy matches the role they were invited into.

5

Journey B · App Store (future)

Once Maddy is on the App Store, the same invite becomes far shorter. A rich preview instead of a bare link, one store instead of two apps, and the code carries itself through install via a deferred deep link. Green markers show each improvement over Journey A.

1 Text + rich preview
9:41iMessage
Hi Rosa! Join my circle in Maddy as one of my support people. Here's the link:
🌤️ Maddy
join.mymaddy.app
You're invited to Jordan's circle

Rich preview unfurls. Maddy branding and Jordan's name are visible before anyone taps.

2 Role-adaptive landing
9:41Safari
🌤️ Invited

You're invited to Jordan's circle

Join as a support person. The plan covers you.

SKY-42F
Get Maddy on the App Store

Real landing page. Name, role, reassurance, and code, all before the store.

3 App Store
9:41App Store
🌤️
Maddy
Warm daily support
GET

★ 4.9 · Health & Fitness · Free

One store, no TestFlight. No second app, no seat limits, no beta caps.

4 Install
9:41App Store
🌤️
Maddy
Installing…

The invite is remembered while it installs.

Code held for later. The deferred deep link keeps SKY-42F attached to this install.

5 Open · code auto-applies
9:41Maddy
🌤️

Welcome. We found Jordan's invite.

You're joining as a support person. Nothing to type.

Join Jordan's circle

Deferred deep link fires. The app opens already knowing the code. No hunting, no typing.

6 Manual fallback (if needed)
9:41Maddy

Have an invite code?

If we didn't catch it automatically, you can enter it here. It's in your text.

SKY-___
Paste from Messages
Join circle

The manual path still exists as a safety net, never the default.

7 Joined
9:41Maddy

You've been invited as a support person.

You'll see what Jordan's working on, leave notes, and see the photos they share. The circle's plan covers you.

Same warm ending, reached in roughly half the steps.

6

Android · Google Play

🤖 For when Android is ready

The Android build is planned as a re-skin, not a re-architecture. The invite path is the same shape, but a few platform details shift, and the preview and deep-link behavior are less consistent than on iOS. Here's what to watch.

💬 Rich preview is inconsistent

On RCS and modern Android messaging the preview card can unfurl, but on plain SMS and many third-party apps it won't. The message copy must stand on its own even when no card appears.

⚠ Design the text to work with zero preview
📥 Google Play link

The store button points at a Play Store listing instead of the App Store. The landing page detects Android and swaps the button and store badge automatically.

⚠ Second store listing to keep in sync
🔑 Deferred deep link via Install Referrer

The code still survives install, but through the Play Install Referrer API rather than iOS's mechanism. It's reliable, though it needs its own implementation and testing pass.

⚠ Separate deep-link plumbing from iOS
No App Clip equivalent

iOS App Clips (and, later, Instant Apps) have no clean Android counterpart we'll rely on. The invitee always does a full install, so keep that path as short as possible.

⚠ Full install is the only path
🎨 Branding to watch

Cotton Candy Sky, Baloo 2, and Lexend all carry to Android, but Material's default ripple, back-gesture, and system fonts can leak in. Lock the theme so the warm, rounded feel survives.

⚠ Guard against Material defaults
🌤️ Same voice, same roles

Caregiver, Supporter, and Peer copy is identical across platforms. No functioning labels, no urgency, no streak-loss language, on any device.

✓ Voice rules hold everywhere