BookMyStay BookMyStay Docs Buy Now
Step 4 · Mobile Apps

iOS Release Build (Apple App Store)

Configure Xcode signing certificates, capabilities, APNs push key, and archive the Customer application for TestFlight and App Store Connect.

Apple App Store 45 min

To compile the iOS application, you require a Mac running macOS, the latest version of Xcode, CocoaPods, and an active Apple Developer Program membership.

1. Install CocoaPods and open Runner workspace

cd customer
flutter pub get
cd ios
pod install

Always open customer/ios/Runner.xcworkspace (never .xcodeproj).

2. Configure Team Signing & Bundle Identifier

In Xcode, click Runner in the left pane → select target Runner → Signing & Capabilities. Tick Automatically manage signing, select your Apple Developer Team, and confirm your Bundle Identifier matches the iOS app in your Firebase project.

3. Verify Required Capabilities

Capability Status Purpose in BookMyStay
Push Notifications Required Delivering check-in, room confirmation, and reservation alerts
Background Modes → Remote notifications Required Processing background booking data messages
Background Modes → Background fetch Required Maintaining up-to-date reservation status

4. Upload the Apple Push Key (APNs) to Firebase

In your Apple Developer Portal, navigate to Certificates, Identifiers & Profiles → Keys → (+). Select Apple Push Notifications service (APNs), click Continue, and download your .p8 auth key file.

Open Firebase consoleProject SettingsCloud Messaging. Under Apple app configuration, select your Customer iOS app and upload the .p8 file alongside your Key ID and Team ID.

5. Build and upload to App Store Connect

cd customer
flutter build ipa --release

Upload the generated customer/build/ios/ipa/*.ipa file using the Apple Transporter application or via Xcode → Product → Archive → Distribute App. Distribute to internal testers through TestFlight before submitting for App Store Review.