open GalaxyBluetooth.xcodeproj in Xcode and choose the GalaxyBluetooth scheme. device and TestFlight builds need your Apple team and signing profile. simulator builds do not need signing.

from this folder, run:

sh ci_scripts/ci_post_clone.sh
xcodebuild -project GalaxyBluetooth.xcodeproj -scheme GalaxyBluetooth -configuration Debug -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NO build

github Actions runs the app tests, simulator build and bridge tests. bluetooth and CarPlay still need a check on real devices.

see Quick start for pairing and Tester guide for connection checks.

app source: natehuby76/ios-clone, branch codex/secretgood-galaxy, commit 081aa0e. the Galaxy UI the app runs keeps its upstream license in UPSTREAM-GALAXY-LICENSE. app store ownership and signing are separate from this repo.

Galaxy screens

The app does not bundle Galaxy's web pages. It downloads them from your comma over Wi-Fi/LAN (GET /api/companion/web-manifest lists the files and their SHA-256), verifies them and saves a copy that Bluetooth uses. Connect over Wi-Fi once before using Bluetooth Galaxy. Custom and unpushed branches work because nothing comes from GitHub. A comma build without that route cannot share its screens: over Wi-Fi the app then reads the pages live from comma, and Bluetooth stays unavailable until the screens have been downloaded.