Skip to main content

⚙️ Config

Configuration File

To configure Sherlo, create a sherlo.config.json file at the root of your project

sherlo.config.json
{
"token": "PROJECT_TOKEN", // "Qak6POAjBpoNhnS9RKqP_wR4Mt_2lnVLLTDyu0H-1"
"android": "BUILD_PATH", // "builds/simulator/preview/android.apk"
"ios": "BUILD_PATH", // "builds/simulator/preview/ios.tar.gz"
"devices": [
{
"id": "DEVICE_ID", // "iphone.15.pro"
"osVersion": "OS_VERSION", // "17"
"osTheme": "OPTIONAL_OS_THEME", // "light"
"osLocale": "OPTIONAL_OS_LOCALE" // "en_US"
}
]
}

Properties

CLI Options

note

Properties marked with * can be set via CLI options in Sherlo Command:

  • token--token
  • android--android
  • ios--ios

Token*

The token is a unique key that authenticates your project with Sherlo

info

To get a token, create a new project or reset the current token in the Sherlo web application

sherlo.config.json
{
"token": "PROJECT_TOKEN", // "Qak6POAjBpoNhnS9RKqP_wR4Mt_2lnVLLTDyu0H-1"
// ...
}

Android*

The android property specifies the path to the Android build

It accepts .apk file format

sherlo.config.json
{
"android": "BUILD_PATH" // "builds/simulator/preview/android.apk"
// ...
}
note

Skip when using Expo Cloud Builds command - Sherlo will get it automatically

iOS*

The ios property specifies the path to the iOS build

It accepts .app, or .tar.gz/.tar file format (as produced by Expo)

sherlo.config.json
{
"ios": "BUILD_PATH" // "builds/simulator/preview/ios.tar.gz"
// ...
}
note

Skip when using Expo Cloud Builds command - Sherlo will get it automatically

Devices

The devices array specifies the configurations for testing devices

Each device includes:

  • id - unique device identifier
  • osVersion - operating system version
  • osTheme (default: light) - operating system theme (light or dark)
  • osLocale (default: en_US) - operating system locale (language_COUNTRY format)
info

Refer to the Devices page for a list of valid id and osVersion values

sherlo.config.json
{
"devices": [
{
"id": "DEVICE_ID", // "iphone.15.pro"
"osVersion": "OS_VERSION", // "17"
"osTheme": "OPTIONAL_OS_THEME", // "light"
"osLocale": "OPTIONAL_OS_LOCALE" // "en_US"
},
// ...
],
// ...
}