Configuration with exp.json

exp.json is your go-to place for configuring parts of your app that don’t belong in code. It is located at the root of your project next to your package.json. The following is a full list of properties available to you.

name
Required. The name of your app as it appears both within Exponent and on your home screen as a standalone app.

description
A short description of what your app is and why it is great.

slug
Required. The friendly url name for publishing. eg: exp.host/@your-username/slug.

privacy
Either public or unlisted. If not provided, defaults to unlisted. In the future private will be supported. unlisted hides the experience from search results. public, unlisted

sdkVersion
Required. The Exponent sdkVersion to run the project on. This should line up with the version specified in your package.json.

version
Your app version, use whatever versioning scheme that you like.

orientation
Lock your app to a specific orientation with portrait or landscape. Defaults to no lock. default, portrait, landscape

primaryColor
On Android, this will determine the color of your app in the multitasker. Currently this is not used on iOS, but it may be used for other purposes in the future. 6 character long hex color string, eg: '#000000'

iconUrl
A url that points to your app’s icon image. We recommend that you use a 512x512 png file with transparency. This icon will appear on the home screen and within the Exponent app.

notification
Configuration for remote (push) notifications.

iconUrl
Url that points to the icon to use for push notifications. 48x48 png grayscale with transparency.

color
Tint color for the push notification image when it appears in the notification tray. 6 character long hex color string, eg: '#000000'

androidMode
Show each push notification individually (default) or collapse into one (collapse). default, collapse

androidCollapsedTitle
If androidMode is set to collapse, this title is used for the collapsed notification message. eg: '#{unread_notifications} new interactions'.

loading
Configuration for the loading screen that users see when opening your app, while fetching & caching bundle and assets.

iconUrl
Url that points to the icon to display while starting up the app. Image size and aspect ratio are up to you. Must be a .png.

exponentIconColor
If no icon is provided, we will show the Exponent logo. You can choose between white and blue. white, blue

exponentIconGrayscale
Similar to exponentIconColor but instead indicate if it should be grayscale (1) or not (0).

backgroundImageUrl
Url that points to an image to fill the background of the loading screen. Image size and aspect ratio are up to you. Must be a .png.

backgroundColor
Color to fill the loading screen background 6 character long hex color string, eg: '#000000'

hideExponentText
By default, Exponent shows some text at the bottom of the loading screen. Set this to true to disable.

appKey
By default, Exponent looks for the application registered with the AppRegistry as main. If you would like to change this, you can specify the name in this property.

androidStatusBarColor
6 character long hex color string, eg: '#000000'

androidHideExponentNotificationInShellApp
By default, Exponent adds a notification to your app with refresh button and debug info. Set this to true to disable.

scheme
Standalone Apps Only. Url scheme to link into your app. For example, if we set this to 'rnplay', then rnplay:// urls would open your app when tapped.

entryPoint
The relative path to your main JavaScript file.

extra
Any extra fields you want to pass to your experience.

rnCliPath

packagerOpts

ignoreNodeModulesValidation

nodeModulesPath

ios
Standalone Apps Only. iOS standalone app specific configuration

bundleIdentifier
The bundle identifier for your iOS standalone app. You make it up, but it needs to be unique on the App Store. See this StackOverflow question. iOS bundle identifier notation unique name for your app. For example, host.exp.exponent, where exp.host is our domain and Exponent is our app.

buildNumber
Build number for your iOS standalone app

config
usesNonExemptEncryption
Sets ITSAppUsesNonExemptEncryption in the standalone ipa’s Info.plist to the given boolean value.

fabric
Twitter Fabric keys to hook up Crashlytics and other services.

apiKey
Your Fabric API key

buildSecret
Your Fabric build secret

googleSignIn
Google Sign-In iOS SDK keys for your standalone app.

reservedClientId
The reserved client id url scheme. Can be found in GoogeService-Info.plist.

supportsTablet
Whether your standalone iOS app supports tablet screen sizes.

android
Standalone Apps Only. Android standalone app specific configuration

package
The package name for your Android standalone app. You make it up, but it needs to be unique on the Play Store. See this StackOverflow question. Reverse DNS notation unique name for your app. For example, host.exp.exponent, where exp.host is our domain and Exponent is our app.

versionCode
Version number required by Google Play. Increment by one for each release. https://developer.android.com/studio/publish/versioning.html.

config
fabric
Twitter Fabric keys to hook up Crashlytics and other services.

apiKey
Your Fabric API key

buildSecret
Your Fabric build secret

googleMaps
Google Maps Android SDK key for your standalone app.

apiKey
Your Google Maps Android SDK API key

googleSignIn
Google Sign-In Android SDK keys for your standalone app.

apiKey
The Android API key. Can be found in the credentials section of the developer console or in google-services.json.

certificateHash
The SHA-1 hash of the signing certificate used to build the apk without any separator :. Can be found in google-services.json. https://developers.google.com/android/guides/client-auth

facebookScheme
Used for Facebook native login. Starts with ‘fb’ and followed by a string of digits, like ‘fb1234567890’. You can find your scheme at https://developers.facebook.com/docs/facebook-login/ios in the ‘Configuring Your info.plist’ section.