Configure app settings (preview)

Use the Copilot Managed Runtime CLI to view and configure settings for an app. The CLI stores configured settings in the app's ms.config.json file.

Available app settings

The following app setting is currently available:

Setting	Type	Default	Description
show-header	Boolean	true	Shows or hides the app header bar.

View app settings

To view all app settings and their effective values, use ms app get-settings:

ms app get-settings

The command displays each setting and its current value:

show-header = true

An effective value includes the default when a setting isn't explicitly configured in ms.config.json.

To return the settings as JSON for use in scripts or automation, add the --json flag:

ms app get-settings --json

The command returns:

{
  "success": true,
  "settings": {
    "showHeader": true
  }
}

Configure an app setting

Use ms app set-setting with the setting flag and a value. Boolean values must be true or false.

For example, to hide the app header bar, run:

ms app set-setting --show-header false

The command updates ms.config.json and confirms the configured value:

show-header = false

The resulting configuration includes the following setting:

{
  "appSettings": {
    "showHeader": false
  }
}

Configured settings take effect the next time you run ms app dev or ms app deploy.