0044. The Apple TV app is its own App Store Connect app, selected only by its release build
- Date: 2026-10-13
- Status: accepted
Context
The Expo TV client ships to the Shield as loomarr.media (0023),
and its Apple TV build has only run in the Simulator under the prototype identity
(media.loomarr.tv.prototype). Internal testers need it through TestFlight, as the iPhone app
already is (0042). An App Store Connect record is bound to
its bundle identifier for good.
Decision
The Apple TV app is a separate App Store Connect app, “Loomarr TV”, with the permanent bundle
identifier media.loomarr.tv (registered as a universal App ID), the same Household internal
testers, and its own build numbers. It does not share the iPhone record: the two apps are different
clients with different screens, and each uploads on its own schedule.
As for the iPhone, development, Storybook and Simulator builds keep the prototype identity; only an
explicit release configuration (LOOMARR_APPLE_RELEASE_CHANNEL=testflight with a validated version
and build number) selects the permanent one, and only for the Apple TV build. The Shield identity is
untouched, and one build cannot select both. Both Apple apps release through one workflow and one
script, which differ only in a table of per-app values.
Consequences
- A push to
mainthat changes the TV client uploads an Apple TV build, as one that changes the iPhone client uploads an iPhone build. - The Apple TV build needs tvOS brand assets (home-screen icon and Top Shelf images), drawn from the
brand contract by
make brand-assets. - Release mechanics live in Releasing (#1500).