id       = "vscodium"
name     = "VSCodium"
homepage = "https://vscodium.com"
description = "Binary releases of VS Code without MS branding, telemetry or licensing."
icon     = "SimpleIcons:vscodium"
# The Homebrew cask links VSCodium.app/Contents/Resources/app/bin/codium to
# $HOMEBREW_PREFIX/bin/codium (Casks/v/vscodium.rb), and the Linux packages
# install the same name, so `codium` is the word a user types.
executables   = ["codium"]

[dotfiles]

# docs/migration.md in VSCodium's own repository lists the user settings folder
# it uses beside VS Code's, so the directory name is stated rather than
# inferred: "__Windows__: %APPDATA%\VSCodium\User", "__macOS__:
# $HOME/Library/Application Support/VSCodium/User", "__Linux__:
# $HOME/.config/VSCodium/User". That trio is [appData] — the same thing
# Electron's app.getPath("appData") returns, which is where VS Code and its
# forks take the directory from — so one spelling stands for all three and
# $XDG_CONFIG_HOME is followed on Linux.
#
# The Homebrew cask's zap list corroborates the macOS half:
# "~/Library/Application Support/VSCodium".
#
# settings.json, keybindings.json and snippets/ are the files that page has you
# copy over from VS Code, and they sit in the same User directory as they do
# there (https://code.visualstudio.com/docs/configure/settings).
paths = [
  "[appData]/VSCodium/User/settings.json",
  "[appData]/VSCodium/User/keybindings.json",
  "[appData]/VSCodium/User/snippets/",
]

# The same migration page: "VSCodium (and a freshly cloned copy of vscode built
# from source) stores its extension files in `~/.vscode-oss`". Installed
# extensions, not settings — and outside the User directory, so this names it
# rather than carving it out. globalStorage/, workspaceStorage/ and History/
# inside User are per-workspace state and are simply not listed above.
exclude = [
  "~/.vscode-oss/extensions/",
]

# No credential file: VSCodium ships without the Microsoft account services, and
# an extension that signs in uses the OS credential store.
secret = []

# No machine_lines, for the reason the `vscode` entry gives: settings.json is a
# preferences file, and which key holds an absolute path differs per extension,
# so a list would be invented rather than found.