id       = "liquidprompt"
name     = "Liquidprompt"
homepage = "https://liquidprompt.readthedocs.io"
description = "A full-featured & carefully designed adaptive prompt for Bash & Zsh."
# The project's own mark, from its GitHub organisation avatar.
icon     = "https://github.com/Liquidprompt.png?size=200"
executables   = ["liquidprompt"]
platforms = ["macos", "linux"]

[dotfiles]

# https://liquidprompt.readthedocs.io/en/stable/config.html — "The config file
# is searched for in the following locations: ~/.liquidpromptrc,
# $XDG_CONFIG_HOME/liquidpromptrc (if XDG_CONFIG_HOME is not set, ~/.config is
# used), $XDG_CONFIG_DIRS/liquidpromptrc, /etc/liquidpromptrc. The first file
# found is sourced."
#
# The first two are the user-level ones; the last two are system files. The XDG
# one is written `[configHome]` rather than a literal ~/.config because the docs
# name the variable, and Liquidprompt is a shell prompt, so it follows XDG on
# macOS as well as Linux.
paths = [
  "~/.liquidpromptrc",
  "[configHome]/liquidpromptrc",
]

exclude = []

# A liquidpromptrc is LP_* shell variables: which segments to show, thresholds,
# colours, the prompt marks. No credentials.
secret = []

# No machine_lines. The file is a list of display preferences — colours,
# thresholds, which VCS and cloud segments to enable — which is exactly what a
# user wants on the next machine. Nothing in it names a host or an absolute
# path.

# The file is sourced once when a shell starts and then held in memory; nothing
# reads it again afterwards, so rewriting it cannot disturb a running shell —
# the new settings simply apply to the next one.
side_effect = false