Installation

Begin by installing SDK in your react-native project:

npm i react-native-stallion

or if you are using yarn then

yarn add react-native-stallion

for steps to install the CLI checkout CLI Installation Docs

After installing the SDK, you need to install pods for iOS and gradle sync android project:

npx pod-install

• Android - Inside MainApplication.java, override and implement getJSBundleFile method :

  MainApplication.java
  // ...other imports
  import com.stallion.Stallion;
  
  public class MainApplication extends Application implements ReactApplication {
    // ...rest of the class
    @Override
    protected String getJSBundleFile() {
        return Stallion.getJSBundleFile(getApplicationContext());
    }
  }
  

  If running on latest version of react-native (>v0.76)
  Inside MainApplication.kt file edit the reactNativeHost method:

  MainApplication.kt
  // ...other imports
  import com.stallion.Stallion
  
  // ...other functions
  override val reactNativeHost: ReactNativeHost =
    object : DefaultReactNativeHost(this) {
      override fun getPackages(): List<ReactPackage> =
        //other methods...
  
        override fun getJSBundleFile(): String? {
            return Stallion.getJSBundleFile(applicationContext)
        }
    }
  

  If running on React Native 82 and above
  Inside MainApplication.kt file, override the reactHost property:

  MainApplication.kt
  // ...other imports
  import com.facebook.react.ReactHost
  import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
  import com.stallion.Stallion
  
  class MainApplication : Application(), ReactApplication {
    override val reactHost: ReactHost by lazy {
      getDefaultReactHost(
        context = applicationContext,
        packageList = PackageList(this).packages,
        jsBundleFilePath = Stallion.getJSBundleFile(applicationContext)
      )
    }
  }
  

• iOS - Inside ios/AppDelegate.mm file edit bundleURL method

  // ...other imports
  #import "StallionModule.h"
  
  @implementation AppDelegate
  // ...other implemetations
  - (NSURL *)bundleURL
    {
      #if DEBUG
        return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];
      #else
        return [StallionModule getBundleURL];
      #endif
    }
  

  If running on latest version of react-native (>v0.76)
  Inside ios/AppDelegate.swift file edit the bundleURL method:

  // ...other imports
  import react_native_stallion
  
  // ...other functions
  override func bundleURL() -> URL? {
      #if DEBUG
          RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
      #else
          StallionModule.getBundleURL()
      #endif
  }
  

• Get projectID from Stallion Dashboard : On project info page, copy project id.

• Generate App Token : Navigate to Project > Project Settings > Access Tokens, and select Generate or Regenerate App Token to create a new token.

Add StallionProjectId & StallionAppToken as shown below -

• iOS: Add the copied App Token and projectId to info.plist

  <plist version="1.0">
    <dict>
      <!-- ...other configs... -->
      <key>StallionProjectId</key>
      <string>66ed03380eb95c9c316256d3</string>
      <!-- make sure app token starts with spb_... and is 46 characters long -->
      <key>StallionAppToken</key>
      <string>spb_FTLx5umZgKLTEyiMNf9-81BgANTOvx7pNhA-gFXbg9</string>
      <!-- ...other configs... -->
    </dict>
  </plist>
  

  

• android: Add the copied App Token and projectId to strings.xml

  <resources>
    <string name="app_name">my_app</string>
    <!-- make sure app token starts with spb_... and is 46 characters long -->
    <string name="StallionProjectId">66ed03380eb95c9c316256d3</string>
    <string name="StallionAppToken">spb_FTLx5umZgKLTEyiMNf9-81BgANTOvx7pNhA-gFXbg9</string>
  </resources>