Get Started with NextNative

Hey, builder 👋

Here's a quick guide to get your project up and start shipping awesome mobile apps with NextNative fast.

Clone and install

In your terminal, run the following commands one-by-one:

git clone https://github.com/lite1pal/nextnative_boilerplate.git [YOUR_APP_NAME]
 
cd [YOUR_APP_NAME]
 
npm i
 
git remote remove origin
 
mv .env.example .env.local

NextNative requires Node 20 or greater. Type node -v in your terminal to check version.

Now make sure your environment is set up (opens in a new tab) for the iOS and Android platforms you will be building for.

Here are the essentials:

iOS requiments

To build iOS apps with NextNative, you’ll need macOS. While tools like Ionic Appflow offer cloud builds, having a Mac is strongly recommended for proper testing.

To get started, you need to install the next:

	•	Xcode (via the App Store, version 16.0+ required)
	•	Xcode Command Line Tools (xcode-select --install)
	•	Homebrew
	•	Cocoapods

Xcode

You can install Xcode by using the Apple App Store (opens in a new tab) on your Mac.

But don't worry, you're going to build everything in your favorite IDE. Xcode is needed to run an emulator.

CocoaPods

To run an iOS app in Xcode emulators, you need CocoaPods.

Check whether you have already them installed:

pod --version

If not, then install them with homebrew:

brew install cocoapods

Install Homebrew (opens in a new tab) if you don't have it.

Android requirements

You need to install Android Studio (opens in a new tab) and Android SDK

If you have a mac M1-M4, I recommend downloading Android Studio Ladybug October 2024 (opens in a new tab) release. It's way more stable and has less cache bugs.

Follow official Capacitor docs (opens in a new tab).

You're almost there 🚀

Now go ahead and follow Ship in 5 minutes tutorial to get your mobile app running!

⚡️ Ship in 5 minutes