Skip to main content
Mobile app running in the Replit Workspace preview with the Preview on device panel and QR code
Build iOS and Android apps with Agent, preview them on your phone, and publish through a guided flow.

​
Getting started

You can get to a working mobile app in a few steps:
1

Create a mobile app

On the Replit home screen, describe your app idea and select Mobile app as the app type.
Replit home screen prompt with Mobile app selected as the app type
2

Test your app

You have two ways to preview a mobile app while you build:
  • In your Workspace: In the Preview panel’s device selector, choose iOS Simulator or Android Emulator. A real simulator streams into your Workspace so you can tap around without leaving Replit. No Xcode or Android Studio required.
  • On a real phone with Expo Go: Install Expo Go on your iPhone or Android device. On desktop, select Open in Expo Go in the Preview panel and scan the QR code. In the Replit Mobile App, tap Open in Expo Go at the top of the preview.
Replit Workspace showing the app preview and the Preview on mobile device option
3

Iterate with Agent

Ask Agent to add features, connect data sources, or integrate services. Keep testing in the simulator or on your phone as you iterate.
The in-workspace iOS Simulator and Android Emulator show the native version of your app, including platform-specific styling and most native components. For features that rely on real hardware — haptics, the camera, push notifications, or location — test on a real phone with Expo Go.

​
Preview on a simulator or emulator

Replit allows you to run and test your mobile apps on your phone using Expo. Alternatively, Replit streams a real iOS Simulator or Android Emulator right into the Preview panel. Changes you make with Agent hot-reload in the simulator, just as they do on a real device.
iOS Simulator and Android Emulator previews are available to builders on Core, Pro, and Enterprise plans. Mobile apps only — the option is hidden for web-only projects.

​
How to open a simulator

1

Open your mobile project

Open a project that has a mobile artifact.
2

Pick your device

In the Preview panel’s device selector at the top, choose iOS Simulator or Android Emulator. The simulator boots in place of the web preview.
3

Interact like a real device

Tap, swipe, type, and navigate using your mouse and keyboard. Select Restart in the toolbar to reload the app without restarting the simulator.
The simulator runs in the cloud and streams to your browser, so there’s nothing to download and nothing to set up. Your project’s files stay on Replit.

​
Browser support

  • Chrome, Safari, and Chromium-based browsers are fully supported.
  • Firefox is not supported. The iOS and Android options appear disabled with a “Firefox not supported” note when you open Replit in Firefox. This is a limitation of the streaming technology that powers the simulator.

​
When to use Expo Go instead

Use Expo Go on a real phone when you need to test features that rely on real hardware or when you want to share a preview with someone who isn’t at your computer:
  • Camera, microphone, haptics, or other native sensors
  • Push notifications
  • Real-world GPS location
  • Sharing a live preview with a teammate, tester, or investor
To open your app in Expo Go, select Open in Expo Go in the Preview panel’s device selector and scan the QR code with the Expo Go app on your phone.

​
Fullscreen simulator

From a mobile artifact card, select More actions → Open in iOS Simulator or Open in Android Emulator to open the simulator in its own tab for a larger viewport.

​
Why build a mobile app?

Build a mobile app when you want:
  • A native experience: Fast performance, smooth interactions, and platform-native UI.
  • Device capabilities: Camera, push notifications, location, and more.
  • App Store distribution: A shareable listing that people can discover and install.

​
Key features

  • AI-first creation: Describe your app, and Agent scaffolds a working mobile app.
  • In-workspace preview: Test on an iOS Simulator or Android Emulator without leaving Replit, or preview on your phone with Expo Go.
  • Full-stack by default: Add server routes, a Database, App Storage, Connectors, and AI integrations as your app grows.
  • Guided publishing: Publish to App Store and submit builds without managing local iOS toolchains.

​
Development workflow

There are three stages for accessing your app, each with different audiences and capabilities:
StageWho can accessHow to accessBest for
DevelopmentYouIn-workspace simulator, or QR code for Expo GoBuilding and iterating
DeployAnyone with Expo GoPublic URL with QR codePrototyping and demos
App StoreAnyoneDownload from App StoreProduction release
Development: When you start your app, you can preview it in the in-workspace iOS Simulator or Android Emulator, or scan a QR code from the Preview panel to open it in Expo Go on your phone. Deploy: When you click Publish, Replit creates a public URL with a QR code. Anyone with Expo Go can scan it and run your app. This is ideal for prototyping—show investors, gather feedback, or test with friends before committing to the App Store. App Store: When you submit to the App Store, users can download and install your app permanently. This requires an Apple Developer account and goes through Apple’s review process.

​
Publishing overview

When you publish for iOS, the flow typically goes:
  • Publish from your Workspace
  • Submit a build to TestFlight
  • Promote a TestFlight build to the App Store in App Store Connect
To publish to TestFlight and submit to the App Store, Apple requires an Apple Developer Program membership.
For a complete walkthrough, see the Build and launch a mobile app tutorial.

​
Build on the go

Your Replit environment runs in the cloud, not on your local machine. This means you can build mobile apps from anywhere—including from the Replit Mobile App. Open your project, prompt Agent, and tap Open in Expo Go to preview your changes on your phone.

​
How the technology works

Your mobile app is built with a stack of technologies that work together. This section explains what powers your app and how the pieces fit together.

​
The technology stack

  • React Native is an open-source framework that lets you write one codebase and compile it to iOS, Android, and web. It renders platform-native UI components, not a webview.
  • Expo simplifies React Native development by handling builds, managing native modules, and providing tools like Expo Go for previews.
  • Expo Go is a free app you install on your phone. It runs your development preview so you can test on a real device without building a full native binary.
When you run your app, the Metro bundler compiles your code and pushes it to your device. The first build takes longer because there’s no cache. Subsequent builds are faster.

​
Architecture: server and client

When you publish a mobile app, you’re deploying two things:
  1. A server that runs on Replit in the cloud. This handles your database, API routes, AI integrations, and backend logic.
  2. A client app that runs on the user’s phone. This is the native app distributed through the App Store or Expo Go.
This separation gives you flexibility. You can run complex logic on the server (where you have access to Replit’s Database, Object Storage, and Connectors) and keep the client lightweight. As you build, think about what should happen on the phone versus what should happen in the cloud.

​
Considerations

  • Publishing requirements: Apple sets the requirements for TestFlight and the App Store.
  • Android publishing: You can build cross-platform apps for iOS and Android. Publishing to Google Play is not supported through a guided experience yet, but can be accomplished manually.
  • Native changes: Changes like app icons or permissions usually require a new store build.

​
Troubleshooting

If you run into issues while developing your mobile app, see Mobile app troubleshooting for common problems and solutions.

​
Next steps

​
FAQs

Expo is what Agent uses to build your mobile app on Replit. It is an open-source platform and toolchain for building, running, and deploying cross-platform native apps with React Native. Learn more at https://expo.dev.
React Native is an open-source framework from Meta for building native iOS and Android apps using React and JavaScript or TypeScript. It renders platform-native UI components (not a webview), so your app looks and feels native.
Expo Go is a free app you install on your phone from the App Store or Google Play. It lets you preview your mobile app during development without building a full native binary. When you scan the QR code in your Workspace, Expo Go downloads and runs your app code.
Expo Go is a pre-built app that runs your code. It’s fast to set up but only supports modules included in the Expo SDK.Dev builds are custom native binaries that can include any native module. They require more setup (EAS Build or local Xcode/Android Studio) but offer more flexibility.Replit uses Expo Go for development previews. If you need native modules not supported in Expo Go, you may need to explore dev builds through Expo’s documentation.
A mobile-responsive web app is a website that adapts its layout in the browser. A React Native app is a native application installed on the device that uses platform APIs (camera, haptics, push notifications), offers better access to hardware and offline capabilities, and is distributed via app stores. Responsive web can be great for reach and zero-install; native is best when you need device features, performance, or App Store distribution.
No. Replit and Expo manage the build process for you in the cloud.
Yes. You can preview in the in-workspace iOS Simulator or with Expo Go on your phone. You only need an Apple Developer account when you’re ready to publish to TestFlight or the App Store.
Yes. You can build cross-platform apps for iOS and Android from the same codebase. Preview on an Android Emulator in your Workspace or on an Android device with Expo Go. Publishing to Google Play can be done manually.
Use Replit’s built-in PostgreSQL, Object Storage, Connectors, and AI integrations—no separate infrastructure required. Your server runs on Replit and your mobile app connects to it.
Use both at different times. The iOS Simulator and Android Emulator in your Workspace show the native version of your app and cover most day-to-day testing — layout, navigation, native components, and platform styling. Switch to a real phone with Expo Go when you need to test features that depend on real hardware, like the camera, haptics, push notifications, or GPS location.