Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Mobile SDK quickstart

Before starting development on the Configured Commerce Mobile SDK, review the prerequisites and required configuration to properly set up your development environment.

Ensure you have the following prerequisites before developing the Commerce Mobile SDK.



The following configuration is required. If you are interested in configuring the Mobile SDK further, refer to Mobile SDK Reference.


All shared code is in the Core project. Update the following files according to your specifications:

  • AppColors.cs
    • Controls colors used in the app. AppConfigurationService from the setting in the Admin Console will override the primary color.
  • Configuration.json
    • Set Domain to the Optimizely Commerce instance you are building the app for and set ShouldUseStaticDomain to true:
    "Domain": "",
    "ShouldUseStaticDomain": true,
    • If ShouldUseStaticDomain is false, the app will behave like an Optimizely testing app where you can change between domains from the settings screen. Setting ShouldUseStaticDomain to false can be helpful during testing or partner builds.



When submitting the application to the Apple App Store or Google Play, DO NOT submit it with ShouldUseStaticDomain set as false.

The app verifies that the Domain string is set in the Configuration.json file upon launch. The app will use that value as the host for all requests if it is set. Otherwise, you are prompted in the app to enter a Domain URL for the app to use.


After configuring the Core project, you will need to set up the Android and iOS projects: