Prerequisites: This project requires Node.js version 18 or higher (we currently use v18.18.0). Please ensure you have Node.js installed on your system before proceeding with the setup process.
To get the best out of Launchtoday, we strongly recommend using physical iOS and Android devices for development and testing. Physical devices provide the most accurate representation of how your app will behave in production, especially when working with libraries like RevenueCat. While simulators and emulators have their place for automated testing and quick UI checks, they should not be your primary development environment.

​
Initial Setup

Getting started with Launchtoday is straightforward with our direct clone option.

​
Direct Clone

Clone the repository directly to get started with your Launchtoday project: 
git clone git@github.com:launchtodayhq/launchtoday-rncli.git [YOUR_APP_NAME]

​
Project Configuration

After successfully cloning the repository, you’ll need to set up your local development environment. Follow these steps in order:
  1. Navigate into your newly created project directory
  2. Execute the following commands to initialize your development environment:
nvm use
cp .env.example .env
yarn
These commands ensure you’re using the correct Node.js version, create your local environment configuration, and install all necessary dependencies.

​
Platform-Specific Configuration

​
iOS Configuration

Setting up your iOS development environment requires a few additional steps:
  1. First, install all required CocoaPods dependencies by running:
npx pod-install
  1. Open your iOS project in Xcode using:
open ios/LaunchToday.xcworkspace
  1. Once in Xcode, you’ll need to configure several important application settings:
    • In the project navigator, select the “Launchtoday” project
    • Select the “Launchtoday” target from the targets list
    • Navigate to the “Signing & Capabilities” tab
    • Update the Bundle Identifier to match your application (e.g., “com.yourcompany.appname”)
    • Choose your Development Team from the dropdown menu
    • If you haven’t already, you may need to sign in with your Apple ID through Xcode preferences
Magic Link Authentication

​
Android Configuration

To set up your Android development environment, you can either follow our detailed step-by-step instructions below or watch our comprehensive video tutorial that walks you through the entire process: The Android setup process requires Android Studio, which you can download from the official Android Developer website. Once installed, follow these detailed steps:
  1. Open Android Studio and launch the AVD (Android Virtual Device) Manager, which allows you to create and manage virtual devices for testing.
  2. Create a new virtual device by following these steps:
    • Click the “Create Virtual Device” button
    • From the hardware profiles, select a device definition (we recommend the Pixel 9 Pro XL)
    • Choose a system image (we recommend API 34 for the best compatibility)
    • Complete the setup process by configuring any additional device settings
  3. Configure your application’s specific settings:
    • Locate and open the android/app/build.gradle file
    • Find the applicationId under defaultConfig and update it to match your desired package name
    • Make sure to sync your project with Gradle files after making these changes
  4. Verify that your development environment is properly configured by running: 
    adb devices
# This command should display your connected device or emulator

​
Running the Application

With your environment configured, you can now launch your application. Choose the appropriate command for your target platform: 
yarn ios:simulator  # Launches the app on your iOS simulator
# or
yarn android        # Launches the app on your Android device or emulator
By default, the ios:simulator command launches your app on an iPhone 15 Pro Max simulator. If you need to target a different iOS simulator, please consult our detailed FAQ guide.
When successfully launched, your application should display the following screen: Application Launch Screen

​
Troubleshooting

If you encounter any difficulties during the setup process or while running the application, we provide several support channels:
  1. Our comprehensive FAQ page addresses common issues and provides detailed solutions
  2. For real-time assistance, join our active Discord community
  3. If you believe you’ve discovered a bug, please create a detailed issue on our GitHub repository
Our dedicated development team and community members are committed to helping you overcome any challenges you might face during your development journey.