> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundchecklive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Invites and onboarding test plan

> QA checks for text message and email invites to an org or a gig, the in-app invite screens, sign-up and sign-in that return to the invite, where invitees land, resending invites, and invite pushes. Says where text invite links open the app and where they open the web.

People join an org or answer a gig invitation from a text message or an email. This plan covers the invite screens, sign-up and sign-in from an invite, and where the person lands next. Read the [QA testing guide](https://docs.soundchecklive.io/qa.md) before you start.

## At a glance

| | |
| - | - |
| **Platforms** | iPhone, Android, and web |
| **Roles** | The invited person, and an owner or admin who sends and resends invites |
| **Feature flags** | `invite-terms-required` decides whether accepting a gig invite asks the person to accept terms. It is on for dev and for listed orgs. |
| **Build** | The in-app invite screens ship over the air. Opening the app from a text invite link needed a native change, which is in current store builds. |
| **Deployed** | See [What's ready](https://docs.soundchecklive.io/qa/scope.md). |
| **Linear** | ENG-1240, ENG-1238, ENG-1241. Flow label `flow/onboarding`. |

## Where a text invite link opens

A text invite link opens the app only where the link's domain is set up for it. Everywhere else it opens the web invite page. The web invite page is the expected result there, not a bug.

| Link domain | iPhone | Android |
| - | - | - |
| `dev.app.soundchecklive.io` | Opens the app. Only a development build can load the invite, because the invite lives on the dev backend. | Opens the browser |
| `qa.app.soundchecklive.io` | Opens the web invite page | Opens the browser |
| `app.soundchecklive.io` | Opens the web invite page until PR 4047 ships | Opens the browser |

To reach the in-app invite screen on any build, open `soundcheck://org-sms-invite/<invitationId>` or `soundcheck://gig-sms-invite/<invitationId>` on the device.

## Before you start

* **A phone number that can receive texts** for the invited person, and an email address you control.
* **An owner or admin account** in the test org.
* **A fresh invitation for each run.** Invitations expire after seven days, and an accepted invitation cannot be reused.

## In scope

### Invite screens (mobile)

| ID | Role and surface | Steps | Expected |
| - | - | - | - |
| INV-01 | Invited person, signed out, mobile | Open an org invite. | **Join** the org name. The subtitle asks you to use an account with the phone number that got the invite, and says invitations expire after seven days. |
| INV-02 | Invited person, signed out, mobile | Open a gig invite. | **Respond to your gig invitation**. |
| INV-03 | Invited person, signed out, mobile | Fill in **First name**, **Last name**, **Email**, and **Password**. Tap **Create account**, then enter the code and tap **Verify email**. | The account is created and you return to the same invite. |
| INV-04 | Invited person with an account, signed out, mobile | Tap **Already have an account? Sign in**, then sign in. | You return to the same invite. |
| INV-05 | Invited person, signed in, mobile | Open the invite. | You are asked to verify the invited phone number on your account, then respond. Org invites offer **Accept invitation**. Gig invites also offer **Decline invitation** and **Maybe**. |
| INV-06 | Invited person, org with `invite-terms-required`, mobile | Accept a gig invite. | **Accept Terms and Conditions** opens. The checkbox stays off until you scroll to the end. **Cancel** sends nothing. |
| INV-07 | Invited person, mobile | Accept or answer a gig invite. | You land in Mailbox. |
| INV-08 | Invited person, mobile | Accept an org invite. | One tap joins the org. You land on a pending offer if you have one, otherwise on your highlighted onboarding card in Mailbox, otherwise on Gigs. |
| INV-09 | Invited person, mobile | Open an org invite that was revoked or already used. | **This invitation is no longer valid**, with **Go to my gigs** or **Set up my workspace**, and **Sign out**. |
| INV-10 | Invited person, mobile | Open an expired org invite. | A message that the invitation has expired. |
| INV-11 | Member of the org, mobile | Open an org invite for an org you already belong to. | A message that you are already a member. |
| INV-12 | Invited person, mobile | Open a gig invite link that does not match your account. | "This invite isn't available for this account" |

### Sign-up edge cases

| ID | Role and surface | Steps | Expected |
| - | - | - | - |
| INV-13 | New user, mobile | Sign up with Apple or Google on an account that hides its name. | **Complete your account** asks for the missing name. |
| INV-14 | New founder, mobile | Start creating an org with an email that already has an account. | **Is this you? Sign in with this email** |
| INV-15 | Invited crew, web | Sign up from a gig invite on web. | A crew account form, not the org owner setup. |
| INV-16 | Invited person, web | Sign up from an org invite on web in a new browser. | You join the inviting org, not a new workspace. |
| INV-17 | Crew claiming an offer, web | Sign up from a crew offer link. | You join the offer's org. |

### Send and resend (owner or admin, mobile)

| ID | Role and surface | Steps | Expected |
| - | - | - | - |
| INV-18 | Owner or admin, mobile | Open **You → Organization Admin → Members**. Tap the resend icon on a pending invite. | **Invitation resent**, or **SMS invitation resent** for a text invite. |
| INV-19 | Owner or admin, mobile | On Gigs, open **⋯ → Invite people**. | The invite flow opens. |
| INV-20 | Owner or admin, mobile | On a gig, open **Staffing → Crew → Invite new people**. | The invite flow opens. It shows only on gigs in your active org. |
| INV-21 | Crew, mobile | Look for resend and invite actions. | None show. |

### Invite push

| ID | Role and surface | Steps | Expected |
| - | - | - | - |
| INV-22 | Manager, then an invited person who has the app | Invite an app user to a gig. | The person gets a push as well as the email. Tapping the push opens Inbox with the invite highlighted. |
| INV-23 | Invited person | Turn off **Event invitations** push in notification settings, then get invited again. | Email only. No push. |

## Out of scope

Do not file these as bugs.

* Text invite links opening the app on production or QA. They open the web invite page until PR 4047 ships.
* Android opening the app from any invite link. Android links are not verified yet, so they open the browser.
* A native org setup screen (ENG-1242).
* Returning to the invite after **Forgot password** (ENG-966).

## Known limitations

* **A store or TestFlight build opened from a dev link** finds no invite, because the build talks to production.
* **An in-app invite to a user who has no push token** reaches no one by push. The email still goes out.
* **While the terms flag is loading,** the app treats terms as required.

## Needs a real device

* Tap a real text invite on an iPhone with a development build and a dev link.
* Tap a text invite on Android 11 and on Android 12 or later.
* Receive a resent invite by text and by email.
* Receive the invite push (INV-22).
* Sign up with Apple or Google on an account that hides its name (INV-13).

## For agents

* **In-app routes:** `soundcheck://org-sms-invite/<id>` and `soundcheck://gig-sms-invite/<id>`.
* **Saved Revyl tests:** `crew-sms-invite-signin-return`, `crew-sms-invite-signup-return`, and `crew-stale-invite-link` in `.revyl/tests/`.
* **Check which domains open the app:** fetch `https://<host>/.well-known/apple-app-site-association` and look for `/org-sms-invite/*` and `/gig-sms-invite/*`.
* **Every invite sends to a real phone or inbox.** Use only numbers and addresses you control.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.