# Settings Pane

A settings modal is available in the app to allow you customize all the various aspects of the application including the theme, language, and styling options. The settings are specified in form of a JSON object. e.g.

  "theme": "light",
  "language": "en-US",
  "addQueryDepthLimit": 6,
  "tabSize": 5

The available options are listed here:

# theme - Specifies the theme

Options include light, dark, dracula, system.

# language - Specifies the language

The options are any of the valid language codes according to: https://support.crowdin.com/api/language-codes/ (opens new window).

However not all the languages are translated. The available translations are English, French, Español, Czech, German, Brazilian, Russian, Chinese Simplified, Japanese, Serbian, Italian, Polish, Korea (opens new window).

# addQueryDepthLimit - Specifies how deep the 'Add query' functionality would go

You can specify any valid number here.

# tabSize - Specifies the tab size in the editor

You can specify any valid number here.

# theme.fontsize - Specifies the base font size

Default: 24

# theme.editorFontFamily - Specifies the font family for the editors

Any valid CSS font family combinations can be used here.

# disablePushNotification - Specifies if native push notifications should be disabled

Default: false

# enableExperimental - Enable experimental features in Altair. Note: The features might be unstable

Default: false

# alert.disableWarnings - Disable warning alerts

Default: false

# plugin.list - Specifies a list of enabled plugins (requires enableExperimental to be true)

Default: [] Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source> (Optional) specifies the source of the plugin. Options include npm, url, github.
  • <plugin-name> Required specifies the name of the plugin. Plugin names must begin with altair-graphql-plugin-.
  • <version> (Optional) specifies the version of the plugin.
  • [<opt>]->[<opt-value>] (Optional) specifies an extra option for the plugin. This is used when you specify the source as url. In that case, you need to specify the URL where the plugin would be sourced from.

Valid plugins in string format include: altair-graphql-plugin-some-plugin, npm:altair-graphql-plugin-some-plugin, npm:[email protected], url:[email protected]::[url]->[http://example.com/some-plugin]

# editor.shortcuts - Contains shortcut to action mapping

Default: {} You can add new editor shortcut mapping following the CodeMirror key map pattern (opens new window). For example, to add a new shortcut to toggle comments, you can add { "Ctrl-7": "toggleComment" }. There are several editor actions you can add shortcuts for including: showAutocomplete, toggleComment, showFinder, showInDocs, fillAllFields, etc. If you want to disable an in-built shortcut, you can use the noOp action. For example to disable Ctrl-/ from toggling comments, you can use { "Ctrl-/": "noOp" }.