Native iOS or React Native?
You choose the platform per project:
Pick iOS app when you want a real native iPhone app that looks and feels like one. Pick Mobile app when you need the same app on iOS and Android.
Create a Native iOS App
On the web: click New Project and choose iOS app (“Native apps for iPhone and iPad, ready for the App Store”). You can also switch the platform picker in the prompt box to iOS before you send your first prompt. On iPhone: tap the new project button and choose iOS app (“Native SwiftUI for iPhone & iPad”). Then describe your app like any other project. The agent writes Swift and SwiftUI, adds Swift packages when it needs them, and builds the app with Xcode after each change.How the Preview Works
Your app runs in a real iOS Simulator in the cloud. What you see in the browser or in the Vibecode iPhone app is a live video stream of that simulator. Your taps, swipes, and typing are sent back to it. No app code runs on your device while you build. That’s why the preview works in any browser and why nothing has to be installed on your phone to test. Preview controls:- Reload: restarts your app in the simulator
- Hard Reset Simulator (web) / Reset simulator (iPhone project menu): starts the simulator fresh if it gets stuck
The preview simulator is an iPhone. Your app is still built for both iPhone and iPad.
Install on Your iPhone
When you want the real app on your own phone, Vibecode builds it, signs it with your Apple Developer account, and gives you an install link. What you need:- A paid Apple Developer Program membership ($99/year)
- An App Store Connect API key with the App Manager or Admin role. You’ll enter its issuer ID, key ID,
.p8key file, and team ID once, and Vibecode reuses it for every build.
- Click Publish and choose Install
- Connect Apple credentials: add your App Store Connect API key
- Register your iPhone: scan the QR code with your iPhone (or tap Register this iPhone if you’re already on it). This installs a small Apple profile that shares your device ID, and Vibecode adds the device to your Apple Developer account for you.
- If your app’s backend isn’t deployed yet, click Deploy when prompted
- Click Build and install and wait for the build to finish
- Scan the QR code (or tap the link on your iPhone) to install the app
Each build uses credits for its cloud build time, whether the build succeeds or fails.
Publish to the App Store
Native iOS projects don’t use Expo. Vibecode builds, signs, and uploads the app to Apple itself.- Click Publish and choose Publish to App Store
- Add your App Store Connect API key if you haven’t already
- Deploy your backend if prompted
- Confirm your bundle ID. You can edit it now, but it can’t be changed after publishing.
- Click Confirm and publish
Your Code
Native iOS projects are standard Xcode projects that use Swift Package Manager for dependencies. You can download the code from the web app or connect via SSH, then open it in Xcode.What’s Different From Mobile App Projects
A few features are specific to React Native projects and don’t apply to native iOS apps:- Share links and the Appsmith app: a native app has no web URL to share. Use Install to put it on your phone.
- Preflight: the App Store preflight check is for Expo projects
- RevenueCat: not available for native iOS apps yet
- Expo integrations such as Expo Push Notifications
Next Steps
Creating Your First App
Write a prompt and generate your app
Choose Your Deployment Path
Compare install, App Store, and web options
