Ship in 5 minutes

Let's get your mobile app running in 5 minutes ⚡️

We're going to use a production-ready template messenger app that I've included.

1. Prerequisite

2. Run a mobile dev server

Use this command to start your mobile app in development mode. It handles:

• Static builds
• Next.js API support
• Watching changes
• Reloading updates

npm run mobile:dev

It starts a local server with Live Reload (opens in a new tab), to which a mobile app will be connected.

iOS

1. Open in Xcode

To launch the iOS app in a simulator:

npx cap open ios

Or simply open Xcode yourself and choose the nextnative/ios folder.

2. Run the Simulator

Click the ▶️ Run button in Xcode to boot your app.

🕓 The first build might take a bit longer — Xcode will compile and set up your project.

✅ All future reloads will be much faster.

Android

1. Add a new Android app on Firebase

In the Firebase console (opens in a new tab):

1. Click Add App → Select Android
2. Enter your app’s Package name (e.g. com.yourcompany.appname)
3. (Optional) Add app nickname
4. Click Register app

2. Download & place config file

1. Download the google-services.json file
2. Place it in:

android/app/google-services.json

3. Edit build.gradle

Go to android/app/build.gradle and replace these lines:

try {
    def servicesJSON = file('google-services.json')
    if (servicesJSON.text) {
        apply plugin: 'com.google.gms.google-services'
    }
} catch(Exception e) {
    logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
}

with only this one line:

apply plugin: 'com.google.gms.google-services'

4. Rerun a mobile dev server

npm run mobile:dev

5. Open in Android Studio

To launch an Android app in an emulator or a real device:

npx cap open android

Or simply open Android Studio yourself and choose the nextnative/ios folder.

6. Run

Click the ▶️ Run button in Android Studio to boot your app.

You’re Live! 🚀

That’s it, you’ve got a native mobile app running with Next.js in just a few minutes.

Go ahead and start building your own features:

Next Steps