Skip to main content
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 before you start.

At a glance

What’s ready 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.

Performance mode

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.

Android Next gig widget

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

Calendar subscribe

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.

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.

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.