id       = "gitkraken"
name     = "GitKraken Desktop"
homepage = "https://www.gitkraken.com"
description = "Millions of devs and teams choose GitKraken Desktop to make Git more visual, accessible and collaborative."
icon     = "SimpleIcons:gitkraken"
# The Linux install instructions say "run `gitkraken` in a terminal", so the
# binary is what a consumer sees. On macOS the bundle identifier is
# com.axosoft.gitkraken, which the Homebrew cask names in `uninstall quit:`
# (https://formulae.brew.sh/api/cask/gitkraken.json).
executables   = ["gitkraken"]

[dotfiles]

# https://help.gitkraken.com/gitkraken-desktop/how-to-install/ — "GitKraken
# Desktop data is stored in: /Users/{user}/.gitkraken or using the shorthand:
# ~/.gitkraken" on macOS, "/home/{user}/.gitkraken or ~/.gitkraken" on Linux,
# and "C:\Users\{user}\AppData\Roaming\.gitkraken" on Windows. The Windows one
# is a genuinely different place — under %APPDATA%, not the profile root — so
# it is listed separately rather than folded into the `~/` spelling.
#
# Only the themes subdirectory is listed, not the whole tree. It is the one
# thing inside that GitKraken documents and that a user writes:
# https://help.gitkraken.com/gitkraken-desktop/themes/ — "Theme files live in:
# ~/.gitkraken/themes/". The parent is deliberately left out: GitKraken's own
# documentation names nothing else inside it, and since it says *all* of the
# app's data lives there, the directory necessarily holds the signed-in account
# state as well — syncing it wholesale would carry authentication material this
# entry cannot name a path for. An entry that syncs a documented directory is
# worth more than one that guesses at the rest.
paths = [
  "~/.gitkraken/themes/",
  "%APPDATA%/.gitkraken/themes/",
]

# No whole-file credential *among the paths above* — a theme is JSON describing
# colours. This is not a statement about the rest of ~/.gitkraken, which is not
# synced here precisely because its contents are undocumented; see the note
# above. GitKraken's caches and session state are outside it in any case, in
# ~/Library/Caches/com.axosoft.gitkraken, ~/Library/HTTPStorages/
# com.axosoft.gitkraken and ~/Library/Cookies/com.axosoft.gitkraken.
# binarycookies, all named in the same cask's zap stanza.
secret = []

# No machine_lines: a theme file is colours and font choices, which is the
# whole reason to carry it.