> ## 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.

# Mobile gig screens test plan

> QA checks for the redesigned gig screen in the mobile app: crew and manager views of Details, Schedule, Staffing, Assets, Tasks, Guest list, Finances, Gear, offers, and agreements, plus the actions that hand off to web.

The gig screen in the mobile app was rebuilt between October 20 and November 18, 2026. Crew and managers see different sections, and some manager actions open the web app on purpose. Read the [QA testing guide](https://docs.soundchecklive.io/qa.md) before you start.

The mobile app is built for crew first. Test every crew check before the manager checks.

## At a glance

| | |
| - | - |
| **Platforms** | iPhone and Android. iPad layouts are in [iPad, Performance mode, and platform](https://docs.soundchecklive.io/qa/ipad-and-performance.md). |
| **Roles** | Crew member, gig manager (owner, admin, gig coordinator, or the gig's creator) |
| **Feature flags** | None for the screens. Gear needs the inventory plan. Hourly pay from approved hours needs the [time clock](https://docs.soundchecklive.io/qa/time-clock.md). |
| **Build** | Ships over the air. No new native build needed. |
| **Deployed** | See [What's ready](https://docs.soundchecklive.io/qa/scope.md). |
| **Linear** | ENG-1634 and its sub-tickets. Flow labels `flow/gig-details`, `flow/crew-staffing`, `flow/agreements`, `flow/pay`. |

> [!NOTE]
>
> Some words change with the org type. In a venue org, "Gig" reads "Event". Report wording only when it differs from the web app for the same org.

## Before you start

* **A crew account** on an active gig with an accepted shift, and on a second gig with a pending offer.
* **A manager account** in the same org.
* **Your own test gig for every write.** Adding crew, reminding crew, and publishing all notify real people. Use a gig whose crew are all test accounts.
* **One org that uses Run of Show and one that does not.** Whether a gig shows **Run of Show** or **Timeline** depends on the org's setup, not on a flag.

> [!WARNING]
>
> Publishing a draft sends every pending invitation and cannot be undone. Never publish a draft in a shared environment unless every invited person is a test account.

## In scope: crew

| ID | Area | Steps | Expected |
| - | - | - | - |
| GIG-01 | Sections | Open a gig as crew. | Section pills read **Details**, **Crew**, **Chats**, and **Assets**. No **More**. |
| GIG-02 | Your shift | Look at **Your shift** on Details. | A status chip, a **Today** chip on show day, start and end times that never wrap, your role, your pay, the access code with copy, and the venue address with Directions. Tapping the crew count opens Crew. |
| GIG-03 | Your pay | Tap your pay. | Pay details expand. An hourly shift shows the pay from the offer. An estimate from unapproved hours is marked pending approval and is not added to the total. |
| GIG-04 | Schedule | Look at the schedule on Details. | Up to 3 rows, then **Open run of show · N cues**. During the show, a live card reads **NOW** with time remaining, and **Up next**. |
| GIG-05 | Schedule | Tap a schedule row. | A read-only cue sheet opens. |
| GIG-06 | Crew roster | Open **Crew**. | Your row shows **(you)** and your pay, with no phone button. Other rows have a phone button. |
| GIG-07 | Assets | Open **Assets**. | Your charts, then the set list, then Files. A song with no length shows a dash, and a **+** on the total means some songs have no length. With no files, no Files section. |
| GIG-08 | Tasks | Open **Your tasks → View all**. | Only your own tasks. Ticking one updates the gig's checklist. |
| GIG-09 | Guest list | Open your guest list. | The allocation card reads like "2 of 3 spots used". The add button is disabled when your spots are full. |
| GIG-10 | Finances | Open the gig's finances as crew. | **My pay**, **My expenses**, and **Net pay**, with only your own rows. You can edit your own unpaid expenses. |
| GIG-11 | Created by | Scroll to the bottom of Details. | "Created" with the date, time, and creator's name. |
| GIG-12 | Offers | Open an offer with no pay in Inbox. | The card reads **No pay listed** in grey, never green. |
| GIG-13 | Offers | Tap **Accept** on an offer. | A confirm opens with **Accept**, or **Accept N days** for a multi-day offer. **Cancel** sends nothing. |
| GIG-14 | Offers | Open an offer that overlaps another shift you hold on the same gig. | A yellow note reads "Also on" the other shift with its times. **Accept** stays available. |
| GIG-15 | Offers | On Gigs home, open **Needs your reply** for a multi-day offer you partly accepted. | **Can't make it** shows next to the replies and opens the **Can't make it?** sheet. A fully pending offer has no **Can't make it**. |
| GIG-16 | Agreements | Open an agreement from Mailbox **Review & sign**, or from the gig's plan. | Agreements with placed signature fields sign in the app: **Review agreement**, **Continue to sign**, **Sign agreement**. Other agreements open on web. |
| GIG-17 | Agreements | Sign a two-party agreement. | The status reads **Signed by you, waiting on** the company until the company signs. |
| GIG-18 | Venue | Open **Venue & load-in**. | See [Travel and venue](https://docs.soundchecklive.io/qa/travel-and-venue.md), checks TV-18 to TV-23. |

## In scope: managers

| ID | Area | Steps | Expected |
| - | - | - | - |
| GIG-19 | Sections | Open a gig as a manager. | Pills read **Details**, **Staffing**, **Checklist**, **Venue**, and **More**. |
| GIG-20 | More | Open **More**. | In-app rows for **Chats**, **Assets**, **Gear**, **Finances**, **Admin notes**, and **Closeout** on past or completed gigs. **Open on web** rows for Contacts and, for org admins, **Full activity log**. |
| GIG-21 | Status | On a draft, look at the banner. | **Draft · hidden from crew** with **Publish gig** and **Change status**. |
| GIG-22 | Status | **⋯ → Change status → Cancel gig**. | The button stays disabled until the impact preview loads. On a draft, the preview says pending invites are cancelled without notice. |
| GIG-23 | Status | Mark a gig settled before every payout is settled. | Blocked with "Settle all payouts in Finances first" or "Mark completed first". Admins see **Override from Closeout**. |
| GIG-24 | Past drafts | Open a draft dated in the past. | "This date is in the past" with **Change date** in place of **Publish**. **Set to Active** says the gig date has passed. |
| GIG-25 | Staffing | Open **Staffing**. | **Crew**, **Labor call**, and **Travel**. Search appears from 8 crew. With nobody staffed: "No one is staffed yet. Add a position to start offering work." |
| GIG-26 | Draft shifts | Open a draft shift. Use **Edit shift**, then **Discard draft**. | Discard asks first, then shows **Draft discarded**. A shift that was already sent says it can't be discarded. |
| GIG-27 | Remind | On an open shift, tap **Remind N people waiting**, add a message, and send. | **Reminder sent to N pending crew**. Not offered on a filled shift. |
| GIG-28 | Spots | **Change spots** on a live open shift. On a multi-day shift, use per-day steppers and **Same for every day**. | Spots update. You cannot go below the number of accepted crew. |
| GIG-29 | Add crew | **Add crew**, review the list, and confirm. | **Asked N people**, or a note that some are on standby because the shift is full. |
| GIG-30 | New shift | Add a new shift for a role that already has one. | Times and pay are copied from the last shift, with a note naming it. Multi-day shifts offer **Copy times to all days**. |
| GIG-31 | Money entry | Enter pay as `1,250`, `$400`, and `42,50`. | The first two save. `42,50` asks whether you mean $42.50 or $4,250, and says to use a dot for cents. |
| GIG-32 | Finances | Open **More → Finances**, tap a row, then **Edit** and **Save changes**. | **Item updated**. Paid lines are read-only. A line offers **Void** or **Delete**, never both. |
| GIG-33 | Crew pay | Open crew pay. | **Left to pay** and "N of M crew paid", with **To pay** and **Paid** lists. Recording a payment opens web. |
| GIG-34 | Gear | Open **Gear**, check items out, then in. | **Pack in** stays blocked until **Pack out** is done. Read-only on the sample gig, archived gigs, and offline. |
| GIG-35 | Guest list | Open **Will call**, check a guest in, then undo. | **Undo check-in?** asks first. Parties of 2 or more get a stepper. |
| GIG-36 | Admin notes | Edit admin notes, save, then edit again and leave without saving. | **Admin notes saved**. Leaving asks **Discard changes?**. A note formatted on web is read-only, with **Edit on web**. |
| GIG-37 | Activity | Open **Recent activity**. | Rows grouped by day, written as sentences. |
| GIG-38 | Empty sections | Open a gig you cannot edit that has no run of show, files, or assets. | Manager wording with **Open on web**. |

## Rules that are easy to break

Spend extra time here. Each of these has broken before.

* **"Past" uses the gig's time zone.** A gig in Los Angeles dated yesterday is not locked for someone in London just after midnight. While the time zone loads, the lock stays closed.
* **Overlap warnings never block.** Back-to-back shifts that touch, such as one ending at 16:00 and the next starting at 16:00, do not warn. A shift that crosses midnight reads "(next day)".
* **Changing spots for the whole shift** never overwrites a day that has its own number.
* **An invalid crew offer fee clears the fee.** Saving anyway sends the shift with no pay.
* **Admin notes saved on mobile never overwrite** formatting someone added on web in the meantime.

## Out of scope

Do not file these as bugs. They open on web by design, or are not built yet.

* Contacts, the full activity log, editing the gear list, labor call, and recording payments, marking paid, and undoing a payment. These open on web.
* Agreements without placed signature fields. These open on web.
* Changing an agreement's field placement (ENG-1870).
* Draft actions on the staffing board view.
* Setting per-day spots while creating an open shift.
* A confirm that names recipients when sending a new shift.
* "Created by CheckAI" or "Imported" on the created line.

## Known limitations

* **Gear needs the inventory plan.** Orgs without it see a prompt to see plans on web.
* **A legacy org that built cues under the old beta flag** does not see them on mobile.
* **The Inbox agreement row** can show **Signed by you** while the agreement list loads.
* **On a gig with several signed agreements**, the plan row opens only the first one.
* **Web says "Unpaid"** where mobile says **No pay listed**. The difference is intended.

## Needs a real device

* Signing an agreement with a finger on a real screen, and on Android.
* Large text (the largest accessibility size) on every section. Revyl cannot change text size.
* Offline: Gear and Finances become read-only, and approving crew hours asks for a connection.

## For agents

* **Seeded gigs on dev:** the `gigs` map in `scripts/shots/sets.json` lists the gig IDs the screenshot sets use, such as `juniper-owner-crew-pay` for owner finances and crew pay and `member-crew-pay` for the crew side. Open one with `soundcheck://events/<id>`. The Revyl seed (`api-events/scripts/seed/revyl/plan.ts`) adds "Harbor Hall · Second call" for run of show activity. Do not accept its "Invitation · Accept journey" gig. Saved Revyl tests use it.
* **Run of Show org:** Northside Event Crew. **Timeline (legacy) org:** Midnight Avenue.
* **Local personas:** `owner.busy` and `member.multi` (`api-events/scripts/seed/README.md`).
* **Missing on dev:** a pending agreement for the test crew account, an open shift, an approved-hours gig, and an offer with no pay. Create these on your own test gig.
* **Saved Revyl tests** that cover this area include `crew-gig-run-of-show`, `crew-offer-cant-make-it`, `owner-finance-line-add`, `owner-guest-checkin`, `owner-shift-offer`, and `owner-gig-task-preview-tick` in `.revyl/tests/`.


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