install-config.example

#!/usr/bin/env bash
# shellcheck shell=bash
# User overrides for ./install. Copy to install-config (gitignored) and edit.
#
# The defaults you'd be overriding live in:
#   - _install/packages/{debian,darwin,arch}   # APT/Brew/Pacman/Mise lists
#   - _install/mise_languages              # Mise programming languages
#   - _install/completions                 # Zsh completion generators
#   - _install/symlinks                    # GNU Stow / ln symlink rules
#   - _install/env                         # Shared helpers + URLs
#
# Each base var (e.g. APT_PACKAGES) replaces the default; each *_EXTRAS var
# appends to it. Empty means "use default". Set a single quoted space (e.g.
# APT_PACKAGES=" ") to skip a category entirely.

set -o errexit

# -----------------------------------------------------------------------------
# Repo / branch overrides
# -----------------------------------------------------------------------------
# Useful if you've forked the repo. DOTFILES_REPO_SLUG is enough for GitHub.
export DOTFILES_REPO_SLUG=
export DOTFILES_CLONE_URL=
export DOTFILES_UPSTREAM_URL=

# -----------------------------------------------------------------------------
# Identity (avoids interactive prompts on fresh systems)
# -----------------------------------------------------------------------------
export YOUR_NAME=
export YOUR_EMAIL=

# -----------------------------------------------------------------------------
# Packages
# -----------------------------------------------------------------------------
export APT_PACKAGES=
export APT_PACKAGES_EXTRAS=

export PACMAN_PACKAGES=
export PACMAN_PACKAGES_EXTRAS=
export AUR_PACKAGES=
export AUR_PACKAGES_EXTRAS=

# Arch only. One of: paru, yay, shelly. Left empty they're detected in that
# order, and paru is built from the AUR if none of them are installed.
export AUR_HELPER=

export BREW_PACKAGES=
export BREW_PACKAGES_EXTRAS=
export BREW_CASK_PACKAGES=
export BREW_CASK_PACKAGES_EXTRAS=

export MISE_PACKAGES_DEBIAN=
export MISE_PACKAGES_DEBIAN_EXTRAS=

export MISE_PACKAGES_MACOS=
export MISE_PACKAGES_MACOS_EXTRAS=

# -----------------------------------------------------------------------------
# Programming languages (Mise)
# -----------------------------------------------------------------------------
# Keys are the binary name; values are passed to `mise use --global`.
declare -A MISE_LANGUAGES=
declare -A MISE_LANGUAGES_EXTRAS=

# Example:
# MISE_LANGUAGES_EXTRAS["ruby"]="ruby@3.4"

export MISE_LANGUAGES
export MISE_LANGUAGES_EXTRAS

# -----------------------------------------------------------------------------
# Zsh completions
# -----------------------------------------------------------------------------
# Keys are the binary name; values are the command that prints a compdef file
# to stdout. The defaults live in _install/completions. Anything already
# completed by pacman or Homebrew is skipped automatically, so *_EXTRAS is for
# tools the default table can't assume everyone has.
declare -A COMPLETION_GENERATORS=
declare -A COMPLETION_GENERATORS_EXTRAS=

# Example:
# COMPLETION_GENERATORS_EXTRAS["railway"]="railway completion zsh"

export COMPLETION_GENERATORS
export COMPLETION_GENERATORS_EXTRAS

# -----------------------------------------------------------------------------
# Symlinks
# -----------------------------------------------------------------------------
# SYMLINKS / SYMLINKS_WSL replace the full default lists; the *_EXTRAS variants
# append. In nearly all cases you want SYMLINKS_EXTRAS, not SYMLINKS.
export SYMLINKS_EXTRAS=
export SYMLINKS_WSL_EXTRAS=