VibeRides

📱 App Store Submission Guide

Two paths: iOS App Store (Capacitor) · Google Play (Bubblewrap)

🎯 Strategy: Capacitor wraps your existing React web app into a real native iOS shell. Apple accepts it — this is the same approach used by Ionic apps in the App Store. You keep your web code exactly as-is.

⚠️ Requirements before you start:

✅ A Mac computer — Xcode only runs on macOS (non-negotiable for iOS builds)

✅ Apple Developer Account — $99/year at developer.apple.com

✅ Xcode installed (free from Mac App Store)

✅ Node.js v18+ installed

✅ Your app's source code (this Base44 project — download via GitHub sync or export)

1Install Capacitor in your project

In your project folder, run:

npm install @capacitor/core @capacitor/cli @capacitor/ios

2Initialize Capacitor

Run the init command — it will ask for your app name and package ID:

npx cap init "VibeRides NYC" com.lionzmen.viberides --web-dir dist

Package ID must match what you register in your Apple Developer account. Use: com.lionzmen.viberides

3Build your web app

Capacitor needs a production build first:

npm run build

This creates the dist/ folder Capacitor will package.

4Add the iOS platform

npx cap add ios

This creates an ios/ folder with a full Xcode project inside it.

5Sync your web code into the iOS project

Every time you update your web app, run this to sync changes:

npx cap sync ios

6Open in Xcode

npx cap open ios

Xcode will open. In Xcode you need to:

Select your project in the left sidebar
Under Signing & Capabilities → choose your Apple Developer Team
Set your Bundle Identifier to com.lionzmen.viberides
Set version number (start with 1.0.0) and build number (1)

7Add App Icons & Splash Screen

Install the splash/icon plugin:

npm install @capacitor/splash-screen
npx cap sync

You'll need a 1024x1024px PNG icon (no transparency, no rounded corners — Apple adds those). Add it in Xcode under Assets.xcassets → AppIcon.

8Archive & Upload to App Store Connect

In Xcode:

Select Any iOS Device (arm64) as the build target (not a simulator)
Menu: Product → Archive
When the Organizer opens, click Distribute App
Choose App Store Connect → upload

✅ Once uploaded, go to appstoreconnect.apple.com, fill out the listing (screenshots, description, category = "Travel"), and submit for review. Apple typically reviews in 1–3 days.

📋 App Store Listing Checklist

✅ App Name: VibeRides NYC

✅ Subtitle: Luxury Party Bus Rentals

✅ Category: Travel (primary), Entertainment (secondary)

✅ Description: Book luxury party buses in NYC for birthdays, proms, weddings, and events. Flat hourly rates. No surge pricing.

✅ Keywords: party bus, NYC, luxury ride, birthday, prom, limo, sprinter

✅ Screenshots: 5 required — use iPhone 6.9" size. Capture: Home, Booking flow, Vehicle detail, Payment page, Booking confirmation.

✅ Privacy Policy URL: https://viberidesnyc.com/PrivacyPolicy

✅ Age Rating: 17+ (due to alcohol-related content at events)

🚨 Common Apple Rejection Reasons to Avoid:

• Missing privacy policy URL → already have one at /PrivacyPolicy ✅

• Broken links or placeholder content → test every button before submitting

• App doesn't work without an account → make sure the Home page loads before login

• Payment flows must use Apple Pay or clearly disclose Stripe — add "Powered by Stripe" near checkout