Remote Configuration

Remote Configuration allows you to define and manage an SDK configuration centrally—without needing to release a new version of your app and without any code changes. Once you’ve saved a configuration and assigned it to your license, any new SDK session running under that license will adopt the remote settings.

Overview

If you want to tweak how the Shen.AI SDK behaves—like modifying the color theme, customizing the measurement preset, or hiding certain UI elements—Remote Configuration gives you a convenient way to do so in real time. You can change the SDK’s entire configuration in the Playground and then assign that configuration to any license. The next time the SDK initializes with that license, it will automatically load the updated settings.

Getting started

1. Log in to the Customer Portal
   Go to admin.shen.ai and sign in with your credentials.

2. Navigate to the SDK Playground
   After logging in, find the “SDK Playground” entry in the menu and click on it to open.

3. Locate the “Remote Configuration” panel
   Inside the Playground, you’ll notice a “Remote Configuration” panel in the lower-right corner of the screen.

Defining your Remote Configuration

Within the Playground, you can experiment with all aspects of the SDK’s behavior:

• Changing the color theme (button colors, text colors, tile background, etc.).
• Choosing the measurement preset (e.g., 30s or 60s measurements, or infinite measurement).
• Modifying the Precision Mode, toggling real-time metrics, or enabling/disabling UI elements.
• Adjusting advanced properties like camera modes, or user flow steps (e.g., Onboarding, Summary screen, etc.).

All changes you make in the Playground are reflected immediately in the embedded preview, so you can verify the look and feel.

Once you’re satisfied, click Save in the “Remote Configuration” panel. Here, you can either:

• Create a brand new configuration,
• Load a previously saved configuration from the list (to edit it further),
• Override an existing configuration with your new settings.

Any settings you tweak will be stored as part of that particular Remote Configuration.

Assigning the configuration to your license

After saving your configuration:

1. Go to the Keys & Downloads page in the Customer Portal.
2. Find the license to which you want to apply the configuration and click the ‘Pen’ icon on the right.
3. Select your saved configuration’s name from the list and click the ‘Save’ button.

Verifying the new configuration in your app

Once a Remote Configuration is assigned to a license, no code changes are required. The next time your app (using that license) initializes the SDK:

1. Shen.AI automatically downloads a remote configuration at the time of license validation.
2. If found, that configuration overrides any default and local settings passed to SDK initialization.
3. The user immediately sees the updated SDK behavior.

There’s no need to resubmit your app to an app store or push any new updates—Remote Configuration handles it in real time.

Troubleshooting and tips

• Changes not appearing?
  Make sure you’ve clicked Save in the Playground, then assigned the saved configuration to your license. Double-check the license key you’re actually using in your app matches the one you assigned in the portal.

• Testing multiple configurations?
  You can switch configurations in the Playground, save them under different names, and assign them in the portal to see how each one behaves.

• Combining with local config?
  If you’re also setting local config options in your app code, remember that the remote config will typically override those settings. If you’d prefer local settings to take precedence, set the remote configuration to ‘Default’.

• Need a rollback?
  Simply assign an older (previously saved) configuration to your license in the “Keys & Downloads” section, or switch off remote config for that license altogether.

Summary

Remote Configuration is a powerful tool for continuously adjusting your SDK’s behavior—like UI colors, measurement presets, or advanced features—without rebuilding or redeploying your app. It centralizes the process in the admin.shen.ai portal, ensuring that any updates you make are instantly reflected for all your end users.

1. Create or update a config in the Playground.
2. Assign that config to your license(s).
3. Run your app with the updated SDK settings—no new app release needed.