📦 Builds

Build Requirements

To test your app with Sherlo, your builds must:

• include Storybook with completed Setup
• be runnable on simulators (Android - .apk, iOS - .app)

Build Types

Sherlo supports two build types for testing:

Preview Simulator Build

This build includes JavaScript bundle, containing all the code needed to run the app

Works with Local Builds and Expo Cloud Builds commands

React Native

Build Commands

Run these commands to build your app:

Android

npx react-native run-android --mode Release

Build Location: android/app/build/outputs/apk/release/app-release.apk

iOS

npx react-native run-ios --mode Release --buildFolder app

Build Location: ios/app/Build/Products/Release-iphonesimulator/[YourProject].app

Expo

EAS Build Profile

Add the following EAS build profile to your eas.json:

eas.json

{
  "build": {
    "simulator:preview": {
      "android": { "buildType": "apk" },
      "ios": { "simulator": true }
    },
    // ...
  },
  // ...
}

EAS Build Profile

Pass this profile name to EAS build command with --profile option

Local

Build Commands

Run these commands to build your app locally:

Android

npx eas-cli build --local --profile simulator:preview --platform android --output builds/simulator/preview/android.apk

Build Location: builds/simulator/preview/android.apk

iOS

npx eas-cli build --local --profile simulator:preview --platform ios --output builds/simulator/preview/ios.tar.gz

Build Location: builds/simulator/preview/ios.tar.gz

note

Expo compresses iOS builds (.app) into .tar.gz files

Cloud

Build Command

Run this command to build your app on Expo servers:

npx eas-cli build --profile simulator:preview --platform all

note

Use --platform option to select only the platforms you plan to test

Development Simulator Build

This build excludes JavaScript bundle, allowing dynamic code loading at runtime

Works with Expo Update command

EAS Build Profile

Add the following EAS build profile to your eas.json:

eas.json

{
  "build": {
    "simulator:development": {
      "developmentClient": true,
      "android": { "buildType": "apk" },
      "ios": { "simulator": true }
    },
    // ...
  },
  // ...
}

EAS Build Profile

Pass this profile name to EAS build command with --profile option

Local

Build Commands

Run these commands to build your app locally:

Android

npx eas-cli build --local --profile simulator:development --platform android --output builds/simulator/development/android.apk

Build Location: builds/simulator/development/android.apk

iOS

npx eas-cli build --local --profile simulator:development --platform ios --output builds/simulator/development/ios.tar.gz

Build Location: builds/simulator/development/ios.tar.gz

note

Expo compresses iOS builds (.app) into .tar.gz files

Cloud

Build Command

Run this command to build your app on Expo servers:

npx eas-cli build --profile simulator:development --platform all

note

Use --platform option to select only the platforms you plan to test