[Tophat] Add Tophat integration for Checkout Kit React Native builds

[kieran-osgood-shopify]

What changes are you making?

Adding a dev tophat command.

dev tophat streamlines the download and installation of a release build (android / swift / react-native) from a PR onto an emulator/simulator.
It's built upon the foundations of https://github.com/Shopify/tophat - which handles the install and bitrise artifact downloading. Selecting the device can be done through tophats menu bar.

dev tophat builds upon fzf to add interactive fuzzy finding to argument selection across all the fields available (author / pr link / pr title)

How does it work

The interface of tophat is simplified into an interactive experience, where each argument is optional and launches into an interactive fzf picker if not supplied, the github urls are pulled from the gh cli
dev tophat
dev tophat <pr-number|pr-url>
dev tophat <pr-number|pr-url> <react-native-ios|react-native-android|ios|android>

Demo

Screen Recording 2026-07-03 at 14.34.02.mov (uploaded via Graphite)

dev tophat defaults to a currently open device, if no device is available it'll prompt you for a device

Auth failure behaviour

In the case of a bitrise failure the prompt is interactive here too and sends the user to the page to create an access token, waiting for the return before continuing

How to test

Try out each of the commands - right now only PR 401 will have artifacts to use

dev tophat
dev tophat <pr-number|pr-url>
dev tophat <pr-number|pr-url> <react-native-ios|react-native-android|ios|android>

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Embedded Checkout Protocol version?

• I have bumped embeddedCheckoutProtocolAndroid in platforms/android/gradle/libs.versions.toml
• I have updated protocol/languages/kotlin/embedded-checkout-protocol/api/embedded-checkout-protocol.api if the public API changed

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kieran-osgood-shopify]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• [Tophat] feat: add the ability to wait for a build to complete #434
• [Tophat] refactor: extract shared browserstack client and reuse http client #433
• [Tophat] Add Bitrise client for Tophat artifact discovery #419
• [Tophat] Add Tophat integration for Checkout Kit React Native builds #401 👈 (View in Graphite)
• [Phase 7] Soft-launch E2E PR checks #364 : 1 other dependent PR (#417 )
• [Phase 6] Report E2E results to GitHub #363
• [Phase 5] Run BrowserStack Maestro from E2E matrix rows #362
• [Phase 4] Build React Native iOS E2E IPA artifact #361
• [Phase 3] Build React Native Android E2E APK artifact #360
• [Phase 2] Add Bitrise E2E pipeline skeleton #357
• [Phase1] Add E2E matrix launch smoke foundation #356
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[bitrise]

Install this build

Open Tophat, select your target device, then click Install. Links open on the Mac running Tophat.

SDK	Install
React Native	Install with Tophat

Checkout Kit E2E results

Status	Suite	Target	Platform	OS version tag	Device
✅	tests/shared/launch-smoke.yaml	react-native	ios	latest	iPhone 15 iOS 27 Beta
✅	tests/shared/launch-smoke.yaml	react-native	android	latest	Google Pixel 9 Android 17.0

[bitrise]

🤖 Bitrise Build Report > Checkout Kit E2E > e2e > #58: ✅ SUCCESS

• Duration: 8m 47s
• Workflows: 6 total / 6 executed / 0 aborted / 0 skipped / 0 failed / 6 successful

[kieran-osgood-shopify]

^I have disabled these bitrise build report comments so its only the one we manually post above in future