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

# iPad, Performance mode, and platform test plan

> QA checks for iPad and large-window layouts, rotation, Performance mode, the Android Next gig widget, calendar subscribe links, the push permission prompt, and app update prompts.

This plan covers device and platform work in the mobile app. Several checks need specific hardware or a specific build, so read each area's gate first. Read the [QA testing guide](https://docs.soundchecklive.io/qa.md) before you start.

## At a glance

| Area | Platforms | Gate | Build |
| - | - | - | - |
| iPad layouts (ENG-2047, 2051, 2052) | iPad, any window 600 points wide or more | None | Over the air |
| Rotation (ENG-2048) | iPad. iPhone only inside Performance mode. | None | Needs iOS build 446 or later |
| Performance mode (ENG-1878, ENG-2049) | iPhone, iPad, Android | `mobile-performance-mode`, Run of Show on the gig | Landscape on iPhone needs iOS build 446 or later |
| Next gig widget (ENG-1361) | Android | None | Needs Android build 408 or later |
| Calendar subscribe (ENG-2114) | Mobile and web | None | Over the air |
| Push permission prompt (ENG-1424) | iPhone, Android | None | Over the air |
| Update prompts (ENG-1928) | iPhone, Android | A published update policy | Needs a real store update |

[What's ready](https://docs.soundchecklive.io/qa/scope.md) shows where each area is deployed. Current TestFlight and store builds are past the build numbers above.

## iPad layouts

Test on an iPad in portrait, then landscape. Repeat the main checks on an 11-inch and a 13-inch iPad if you have both.

| ID | Steps | Expected |
| - | - | - |
| PAD-01 | Open Gigs, Inbox, Organization, and You in portrait. | Content sits in a centered column. The purple header reaches both edges. The tab bar is narrower and solid. |
| PAD-02 | Rotate to landscape on each tab and on a gig. | Every screen rotates. Typed text, scroll position, the keyboard, and open sheets stay in place. |
| PAD-03 | On a 13-inch iPad or in landscape, open **Gigs → Calendar**. | The month shows beside the list. |
| PAD-04 | On a 13-inch iPad or in landscape, open **Inbox → Messages** and pick a message. | It opens in a pane on the right. **View gig** opens the gig. |
| PAD-05 | Open a gig in landscape. | Details on the left, Crew or Staffing on the right. |
| PAD-06 | Open a gig's run of show. | Day columns for Start, End, Length, Cue, and Notes. |
| PAD-07 | Open a gig chat. | The thread sits in a narrower readable column. |
| PAD-08 | As a manager, open Staffing. | The staffing board layout. |
| PAD-09 | Open **Location & travel** in your profile. | State, Postal code, and Country share one row. |
| PAD-10 | Repeat PAD-01 and PAD-05 on an iPhone. | Nothing changes from the phone layout, and the app stays portrait. |

## Performance mode

> [!WARNING]
>
> The `mobile-performance-mode` flag is not set up in PostHog, so Performance mode is hidden in TestFlight and store builds. It shows only in builds that turn the flag on at build time, such as the Revyl build. If you cannot see **Perform**, that is expected. Ask the QA lead before you file it.

**Perform** shows only on a gig with a run of show, for an active or draft gig. It is hidden on cancelled, archived, completed, settled, template, and sample gigs.

| ID | Steps | Expected |
| - | - | - |
| PERF-01 | Open a gig with a run of show. | A **Perform · N cues** button. If the run of show fails to load: "Couldn't load run of show" with **Retry**. |
| PERF-02 | Open a cancelled, archived, template, or sample gig. | No **Perform** button, and no empty gap where it would be. |
| PERF-03 | Open Perform. | A dark screen with a close button, the gig title and venue, a clock, and "Cue n of N". **NOW**, **COMING UP**, or **DONE** on the cue, then **Up next** and **Later**. |
| PERF-04 | Use **Prev**, **Next**, and **Jump**. | Cues change. **Jump** lists cues with **ON SCREEN** and **NOW** marks. **Next** on the last cue goes back to the first. |
| PERF-05 | Scroll away from the current cue. | **Jump to now** appears and returns to it. |
| PERF-06 | Open a cue with a PDF chart. Pinch, double-tap, then **Reset zoom**. | The chart zooms and resets. A cue with no chart says "No chart attached to this song." |
| PERF-07 | iPhone: rotate to landscape inside Perform. | The chart fills the width and scrolls down. A sideways swipe changes cue. Zoom survives the rotation. |
| PERF-08 | iPhone: close Perform while sideways. | The gig returns in portrait. Gigs and the gig screen never rotate on iPhone. |
| PERF-09 | iPad: open Perform and wait 4 seconds. | The controls fade. Tapping the middle brings them back. Tapping an edge turns the page, then moves to the next cue. |
| PERF-10 | iPad landscape: tap **Hide** on the run of show. | Two PDF pages show side by side. |

## Android Next gig widget

Needs Android build 408 or later. An over-the-air update cannot add the widget.

| ID | Steps | Expected |
| - | - | - |
| WID-01 | Add a widget from the home screen picker. | **Next gig** (small) and **Next gig (wide)** are offered. |
| WID-02 | Look at the widget with an upcoming gig. | The gig, its call time ("Call" and a time, or "Call time TBD"), and "Starts in" a countdown. **LIVE** during the gig. |
| WID-03 | Tap the widget. On the wide widget, tap **Directions**. | The gig opens. **Directions** opens the map chooser. |
| WID-04 | Sign out. | "Sign in to see your next gig". |
| WID-05 | Force-quit the app. Have a manager reschedule the gig. | The widget shows the new time within about a minute. |

## Calendar subscribe

| ID | Steps | Expected |
| - | - | - |
| CAL-01 | Open **Gigs → ⋯ → Calendar sync**, or **You → Settings → Calendar Sync**. Tap **Create calendar link**. | **Copy link**, **Apple Calendar**, **Google Calendar**, and **Outlook**. |
| CAL-02 | Tap **Apple Calendar** on an iPhone. | The Calendar app offers to subscribe. If it cannot open, the link is copied and the app says to follow the Apple Calendar steps below the buttons. |
| CAL-03 | Subscribe in Apple Calendar and wait for it to refresh. | Your gigs appear in the calendar. |
| CAL-04 | Tap **Google Calendar** with Google not connected, then connected. | Not connected starts the connect flow. Connected says Google Calendar is already connected. |
| CAL-05 | On web, open the calendar card in Settings and use the Apple option. | The link is copied and the Apple steps appear. |

A subscription that failed before ENG-2114 does not fix itself. Remove it and subscribe again.

## Push permission prompt

These checks need a real phone. A simulator cannot show the system notification prompt.

| ID | Steps | Expected |
| - | - | - |
| PUSH-01 | Install fresh and sign in. | No system prompt at launch. A Soundcheck sheet asks to turn on notifications, with **Turn on** and **Not now**. |
| PUSH-02 | Tap **Not now**, then reopen the app the same day. | The sheet does not come back. It shows at most three times, at least 14 days apart. |
| PUSH-03 | Deny notifications, then open **You → Settings → Notifications**. | "Push notifications are off" with **Open Settings**. |

## Update prompts

These checks need a published update policy and a real store update. Run them only with the QA lead, who sets the policy. See `docs/engineering/mobile/update-policy-verification.mdx` in the repository.

| ID | Steps | Expected |
| - | - | - |
| UPD-01 | Open an old build under a required update policy. | **Update Soundcheck to continue** with **Update now**. |
| UPD-02 | Open an old build under a recommended update policy. | **A new Soundcheck is available** with **Later**. |
| UPD-03 | Update from the store and reopen. | The prompt is gone. |

## Out of scope

Do not file these as bugs.

* Performance mode in TestFlight or store builds. See the warning above.
* Fold and unfold support for foldable iPhones (ENG-2053, ENG-2054). It needs a newer Xcode.
* Android tablet layouts (ENG-2056) and store screenshots for iPad (ENG-2057).
* Two-column gig cards, a sidebar, columns that scroll on their own, and timeline or set list grids on iPad.
* Performance mode page dimming, night tint, half-page turns, foot pedals, and offline charts (ENG-2096, ENG-2097, ENG-1488, ENG-1487).
* **Open Performance view** on a cancelled gig's media tab is not hidden yet.
* Rotation and the widget on iOS build 410 or older. Those builds cannot take the native change.

## Needs a real device

* Rotation on real iPad hardware, and Split View or Stage Manager windows narrower than 600 points.
* iPhone rotation inside Performance mode, including which side the notch is on.
* Android rotation inside Performance mode.
* The Android widget under battery saver, and after the app is force-stopped.
* Every push permission and update prompt check.
* Apple Calendar actually filling in after a subscribe.

## For agents

* **Size classes** come from `lib/layout/windowClass.ts`: widths break at 600 and 840 points. Content is capped at 720 points and sheets at 640 points.
* **iPad simulators:** claim one with `--device-class ipad-11` or `ipad-13`. See `docs/engineering/mobile/agent-screenshots.mdx` in the repository. Rotation cannot be driven reliably on the simulator, so mark PAD-02 `NOT RUN` unless you can rotate.
* **Performance mode** needs `EXPO_PUBLIC_FF_MOBILE_PERFORMANCE_MODE=true` in the Metro environment, or the dev menu's feature flag toggle in a development build.
* **Analytics:** one `performance_mode_item_viewed` per cue, and none from rotating. `update_gate_cleared` fires on the first launch after a store update.


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