Environment configuration lets you set different values for your solution's apps and pipelines across each environment—Development, Testing, and Production. Use it to control things like app names, branding colors, icons, pipeline names, and more, without changing the underlying structure of your solution.
What you can configure
Built-in parameters are defined by the system and appear automatically for any app or pipeline in your solution. You can edit the value for each parameter per environment, but you can't delete them.
App parameters include:
App name
App icon
Header background color
Header text color
App variables
Pipeline parameters include:
Pipeline name
Call definition and value
Where environment configuration appears
You can view and edit environment configuration in three places.
During environment creation
When you create environments for a new solution, you'll configure environment parameters as part of the setup. After completing the initial setup step, you'll see the Environment configuration step.
This step shows default values for each parameter across your environments. Review and edit any values before you finish creating the environments. All parameters must have a value before you can continue.
During deployment
When you publish changes from one environment to another, the deployment review includes an Environment configuration step.
Review and update any values for the target environment before publishing. All parameters must have a value before you can publish.
Parameter value changes are applied to the target environment when you publish. They're also recorded in version history.
Environment configuration page
The Environment configuration page is the main place to manage environment configuration outside of a deployment. To open it, select Environment configuration in the left navigation of your solution.
The page shows all apps and pipelines in your solution, with columns for each environment. Values shown in gray are read-only (they come from Development and can't be edited here). Values in white are editable for Testing and Production.
Filter by App or Pipeline, or search for a specific parameter.
Note
Saving changes on the Environment configuration page does not apply to those environments immediately—you must publish changes between environments for the new parameters to take effect.
To edit a value:
Select the field in the Testing or Production column.
Enter or select the new value.
Select Save changes.
For color parameters, a color picker opens when you select the field. You can choose from the palette or enter a hex value. For icon parameters, an icon picker opens so you can search and select from the available icons.
To sync parameters from Development:
Syncing loads the latest values from Development into the Environment configuration page. This is useful if the Development environment has been updated since you last reviewed configuration.
Select Sync parameters.
If you have unsaved changes to Testing or Production values, you'll be asked whether to save or discard them before syncing.
Select Save & sync or Discard & sync.
Note
Syncing updates the page view only. Changes don't take effect in Testing or Production until you publish.
Permissions
All solution contributors can view and edit parameter values. Realm admins have read-only access to parameters.