Documentation

iOS Keyboard Theme

The KBThemes.json file contains the details for each local theme of the keyboard extension. The structure of the JSON file is an array of themes, each with the following structure:

{
    "id": "unique_theme_id",
    "order": 0,
    "kb1_toolbar_items_color": "#ffffff",
    "kb2_toolbar_active_item_color": "#EF4157",
    "kb3_toolbar_bg_color": "#4187EF",
    "kb4_main_elements_color": "#EF4157",
    "kb5_secondary_elements_color": "#FDBE16",
    "kb6_misc_elements_color": "#EF4157",
    "kb7_keyborders_bg_color": "#ffffff",
    "kb8_keyborders_text_color": "#000000",
    "kb9_no_keyborders_text_color": "#151515",
    "kb10_neutral_status_color": "#494369",
    "kb11_good_status_color": "#51bd9f",
    "kb12_warning_status_color": "#fbbc17",
    "kb13_bad_status_color": "#ed4057",
    "kb14_main_color_foreground_color": "#ffffff",
    "kb15_keyboard_background_color": "#F9F7F7",
    "kb16_keyboard_cards_color": "#EDEDED",
    "kb17_abc_items_color": "#474747",
    "kb18_abc_bar_background_color": "#EDEDED",
    "kb19_keyboard_text_color": "#000000",
    "kb_toolbar_items_logo": "kb_toolbar_items_logo_0",
    "kb_wallpaper_portrait": "kb_wallpaper_portrait_0",
    "kb_wallpaper_landscape": "kb_wallpaper_landscape_0"
  },
  • "id" - unique string that identifies a theme. It can be used with the filterThemesById(ids: [String]) in order to hide/show that theme in the Themes section.
  • "order" - controls the order of presentation of the themes in the themes management view of keyboard. Default theme is the first one in the order of this field.
  • "kb[1-3]_toolbar_*” - toolbar colours
  • “kb[4,5]_" - main and secondary brand colours in the context of keyboard
  • “kb6_misc_elements_color” - miscellaneous colour
  • "kb[7,8]_keyborders_*” - colours used for keys with key borders
  • “kb9_no_keyborders_text_color” not used iOS currently
  • "kb1[0-3]_*_status_color" - status colors for neutral, good, warnings, errors
  • "kb14_main_color_foreground_color" - main color foreground color
  • "kb15_keyboard_background_color" - keyboard background
  • "kb16_keyboard_cards_color" - keyboard cards
  • "kb17_abc_items_color" - color of ABC button
  • "kb18_abc_bar_background_color"- color of ABC bar
  • "kb19_keyboard_text_color" - color of keyboard texts
  • "kb_toolbar_items_logo" - the name of the UI asset that exists in Media.assets and contains the toolbar brand logo for the current theme

Assets

  • "kb_wallpaper_portrait" & "kb_wallpaper_landscape" - not used in the current version of the SDK