{
  "title": "AppBar Preferences",
  "description": "Custom preferences for the AppBar menu bar application. Preference domain: com.zappl.AppBar",
  "properties": {
    "Title": {
      "title": "Title",
      "description": "The title text shown in the top left of the AppBar window",
      "type": "string",
      "default": "AppBar",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "TitleFontSize": {
      "title": "Title Font Size",
      "description": "The font size of the title text shown in the top left of the AppBar window. Accepts numerical values between 16 and 32. Values outside this range will default to 22",
      "type": "number",
      "default": 22,
      "minimum": 16,
      "maximum": 32,
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "CustomLogo": {
      "title": "Custom Logo",
      "description": "The logo shown to the left of the title text. Can be a file path, URL to an image, or an SFSymbol name. Defaults to the 'Custom Logo (Dark Mode)' option if specified, or the 'app.badge.fill' SFSymbol if neither Custom Logo options are specified. Jamf Pro customers can use 'selfService' to set this as the Jamf Self Service icon",
      "type": "string",
      "default": "app.badge.fill",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "CustomLogoDark": {
      "title": "Custom Logo (Dark Mode)",
      "description": "The logo shown to the left of the title text in dark mode. Can be a file path, URL to an image, or an SFSymbol name. Defaults to the 'Custom Logo' option if specified, or the 'app.badge.fill' SFSymbol if neither Custom Logo options are specified. Jamf Pro customers can use 'selfService' to set this as the Jamf Self Service icon",
      "type": "string",
      "default": "app.badge.fill",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "NotificationIcon": {
      "title": "Notification Logo",
      "description": "A path or URL to a custom branding logo shown to the right hand side of macOS notifications",
      "type": "string",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "MenuBarIcon": {
      "title": "Menu Bar Icon",
      "description": "Either a path to an icon (must be 16x16 points) or an SFSymbol name to be used as the menu bar icon. Defaults to the 'square.and.arrow.down.on.square' SFSymbol if not specified",
      "type": "string",
      "default": "square.and.arrow.down.on.square",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "AccentColor": {
      "title": "Accent Colour",
      "description": "Custom colour to be used for buttons and highlighting. Accepts hex colour codes (e.g., #0000FF). Defaults to macOS system accent colour if not specified",
      "type": "string",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "CustomCategories": {
      "title": "Custom Categories",
      "description": "Customise the default categories apps are assigned to in the installs tab by specifying app identifiers and their desired custom category labels",
      "type": "array",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ],
      "items": {
        "type": "object",
        "title": "Category Mapping",
        "properties": {
          "identifier": {
            "type": "string",
            "title": "App Identifier",
            "description": "The identifier of the application (e.g., com.example.app)",
            "links": [
              {
                "rel": "More Info",
                "href": "https://docs.zappl.co/appbar/appbar-preferences"
              }
            ]
          },
          "category": {
            "type": "string",
            "title": "Category Label",
            "description": "The custom category label to assign to this app",
            "links": [
              {
                "rel": "More Info",
                "href": "https://docs.zappl.co/appbar/appbar-preferences"
              }
            ]
          }
        },
        "required": [
          "identifier",
          "category"
        ]
      }
    },
    "CustomDescriptions": {
      "title": "Custom Descriptions",
      "description": "Customise the descriptions shown for apps in the installs tab by specifying app identifiers and their desired custom descriptions",
      "type": "array",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ],
      "items": {
        "type": "object",
        "title": "Description Mapping",
        "properties": {
          "identifier": {
            "type": "string",
            "title": "App Identifier",
            "description": "The identifier of the application (e.g., com.example.app)",
            "links": [
              {
                "rel": "More Info",
                "href": "https://docs.zappl.co/appbar/appbar-preferences"
              }
            ]
          },
          "description": {
            "type": "string",
            "title": "Description Text",
            "description": "The custom description to display for this app",
            "links": [
              {
                "rel": "More Info",
                "href": "https://docs.zappl.co/appbar/appbar-preferences"
              }
            ]
          }
        },
        "required": [
          "identifier",
          "description"
        ]
      }
    },
    "InstallsTabEnabled": {
      "title": "Installs Tab Enabled",
      "description": "Determines whether the installs tab is enabled. Disabled by default. When disabled, users will see a message indicating installs are not allowed. When enabled, users can use the installs tab to install approved apps. To customise approved apps, use the 'Allowed Installs' or 'Excluded Installs' options in the com.dare.zappl.preferences configuration profile",
      "type": "boolean",
      "default": false,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "InstallsTabHidden": {
      "title": "Installs Tab Hidden",
      "description": "Completely hides the Installs tab from the UI when selected. Disabled by default. Only takes effect when 'Installs Tab Enabled' is unchecked above. When this option is enabled, the Installs tab will not be visible to users at all. This removes the \"Your administrator has not allowed app installs\" dialogue shown when 'Installs Tab Enabled' is unchecked.",
      "type": "boolean",
      "default": false,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "HistoryTabEnabled": {
      "title": "History Tab Enabled",
      "description": "Determines whether the history tab is enabled. Uncheck to hide the history tab which shows recent updates, installs and failures",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "LiquidGlassEnabled": {
      "title": "Liquid Glass Enabled",
      "description": "Enables the liquid glass effect on macOS 26 (Tahoe) and later. This option has no effect on macOS versions prior to macOS 26",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "AllowUpdateNotifications": {
      "title": "Allow Update Notifications",
      "description": "Shows a macOS notification when new updates are cached by Zappl and are available to be updated via AppBar. Requires a notifications configuration profile which approves com.zappl.AppBar notifications",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "AllowInstallNotifications": {
      "title": "Allow Install Notifications",
      "description": "Shows a macOS notification when installs complete. Requires a notifications configuration profile which approves com.zappl.AppBar notifications",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "AllowFailureNotifications": {
      "title": "Allow Failure Notifications",
      "description": "Shows a macOS notification when installs or updates fail. Requires a notifications configuration profile which approves com.zappl.AppBar notifications",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "EnableQuitButton": {
      "title": "Enable Quit Button",
      "description": "Enables the quit button when right-clicking the menu bar icon. Uncheck to disable",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    },
    "EnableAboutButton": {
      "title": "Enable About Button",
      "description": "Enables the about button which shows AppBar information such as installed version when right-clicking the menu bar icon",
      "type": "boolean",
      "default": true,
      "format": "checkbox",
      "links": [
        {
          "rel": "More Info",
          "href": "https://docs.zappl.co/appbar/appbar-preferences"
        }
      ]
    }
  }
}