React Native App (macOS + iOS)

This section outlines how to configure your macOS environment to build and run the Numberlee mobile app on iOS.

Installing Dependencies (macOS – for iOS Development)

To build and run the iOS version of Numberlee, you’ll need to install a few essential tools and libraries:

Required Tools:

  • Node.js — JavaScript runtime needed to run React Native.

  • Watchman — A file watcher recommended for faster development (especially on macOS).

  • React Native CLI — The command-line interface to scaffold and manage React Native projects.

  • Xcode — Required to compile and run the app on iOS devices and simulators.

  • CocoaPods — A dependency manager for native iOS modules.

Node & Watchman

We recommend installing Node and Watchman using Homebrew. Run the following commands in a Terminal after installing Homebrew:

brew install node brew install watchman

If you have already installed Node on your system, make sure it is Node 18.18 or newer.

Watchman is a tool by Facebook for watching changes in the filesystem. It is highly recommended you install it for better performance.

Xcode

Please use the latest version of Xcode.

The easiest way to install Xcode is via the Mac App Store. Installing Xcode will also install the iOS Simulator and all the necessary tools to build your iOS app.

Command Line Tools

You will also need to install the Xcode Command Line Tools. Open Xcode, then choose Settings... (or Preferences...) from the Xcode menu. Go to the Locations panel and install the tools by selecting the most recent version in the Command Line Tools dropdown.

Installing an iOS Simulator in Xcode

To run Numberlee on an iOS simulator, you'll first need to install one through Xcode.

✅ Steps to Install an iOS Simulator:

  1. Open Xcode.

  2. Go to Xcode → Settings… (or Preferences… on older versions).

  3. Click on the Platforms (or Components) tab.

  4. Click the "+" icon and choose iOS… from the list.

  5. Select the iOS version you'd like to install (we recommend using the latest stable version).

Once installed, you can launch your app using this simulator from the terminal or within Xcode.

CocoaPods (iOS Dependency Management)

CocoaPods is a dependency manager for iOS that integrates third-party libraries into your Xcode project. It’s required to install native modules in React Native for iOS.

🛠 Installation:

CocoaPods is a Ruby gem, and macOS comes with Ruby pre-installed.

To install CocoaPods:

sudo gem install cocoapods

Alternatively, if you use Homebrew:

brew install cocoapods

Verify Installation:

After installation, confirm it's set up correctly by running:

pod --version

For more details, refer to the official CocoaPods Getting Started Guide.

Now Setup the Firebase

Last updated