Stack

stack

Stack is a program for developing Haskell projects, aimed at new and experienced users and supporting Linux, macOS and Windows.

Detected by stack | macOS, Linux, Windows |haskellstack.org

Sync it stack.toml

Sync rules

What travels, what stays, what never leaves

Stack in your home directory Every rule on this page, by file

…

save-hackage-creds: false

allow-different-user: false

local-bin-path: /Users/octocat/.local/binmachine-local

local-programs-path: /Users/octocat/.stack/programsmachine-local

extra-include-dirs:

- /opt/homebrew/include

extra-lib-dirs:

- /opt/homebrew/lib

extra-path:machine-local

- /opt/homebrew/bin

Each machine keeps its own copy of these.

…

local-bin-path: /Users/octocat/.local/bin

local-programs-path: /Users/octocat/.stack/programs

extra-include-dirs:machine-local

- /opt/homebrew/include

extra-lib-dirs:machine-local

- /opt/homebrew/lib

extra-path:

- /opt/homebrew/bin

Each machine keeps its own copy of these.

· upload/credentials.json Never synced

…

system-ghc: false

save-hackage-creds: false

local-bin-path: C:/Users/octocat/AppData/Roaming/local/binmachine-local

local-programs-path: C:/Users/octocat/AppData/Local/Programs/stackmachine-local

extra-include-dirs:

- C:/msys64/mingw64/include

extra-lib-dirs:

- C:/msys64/mingw64/lib

extra-path:machine-local

- C:/msys64/mingw64/bin

Each machine keeps its own copy of these.

…

local-bin-path: C:/Users/octocat/AppData/Roaming/local/bin

local-programs-path: C:/Users/octocat/AppData/Local/Programs/stack

extra-include-dirs:machine-local

- C:/msys64/mingw64/include

extra-lib-dirs:machine-local

- C:/msys64/mingw64/lib

extra-path:

- C:/msys64/mingw64/bin

Each machine keeps its own copy of these.

· upload/credentials.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/stack.tomlThe file this page is generated from

id = "stack"

name = "Stack"

homepage = "https://haskellstack.org"

description = "Stack is a program for developing Haskell projects, aimed at new and experienced users and supporting Linux, macOS and Windows."

# Stack's own favicon, from its documentation site.

icon = "https://docs.haskellstack.org/en/stable/img/stack-favicon.svg"

detect = ["stack"]

# https://docs.haskellstack.org/en/stable/topics/stack_root/ — the Stack root

# is ~/.stack on Unix-like operating systems and %APPDATA%\stack on Windows,

# and config.yaml in it is "Stack's global configuration file". The rest of the

# root (pantry/, programs/, snapshots/, stack.sqlite3, setup-exe-cache/) is

# multi-gigabyte build state, so only the config file is listed.

paths = ["~/.stack/config.yaml", "%APPDATA%/stack/config.yaml"]

exclude = []

# Same page: the upload directory "may contain saved credentials for uploading

# packages to Hackage (credentials.json)" — written when save-hackage-creds is

# left at its default. A Hackage username and password, whole file.

secret = ["~/.stack/upload/credentials.json", "%APPDATA%/stack/upload/credentials.json"]

# Both spellings, or a Windows machine syncs its own C:\ paths out. Every key

# here names a directory that exists on this machine only:

# https://docs.haskellstack.org/en/stable/configure/yaml/non-project/ —

# local-bin-path is "the target directory for stack build --copy-bins and

# stack install", local-programs-path "overrides the location of the Stack

# 'programs' directory, where tools like GHC get installed", extra-include-dirs

# and extra-lib-dirs are "extra paths to be searched for header files" and

# "for libraries" (typically a Homebrew or MSYS2 prefix), and extra-path is

# "additional directories to prepend to the PATH".

# templates.params (author-name, author-email, github-username) is deliberately

# not here: that is identity the user wants on every machine.

# local-bin-path, local-programs-path and extra-path are the user's own layout —

# where their binaries go, where GHC gets installed, what they prepend to PATH —

# so they are kept for rebuilding this machine and applied to no other.

[[machine_lines]]

file = ["~/.stack/config.yaml", "%APPDATA%/stack/config.yaml"]

match = { key_path = [

"local-bin-path",

"local-programs-path",

"extra-path",

] }

scope = "backup"

# extra-include-dirs and extra-lib-dirs are the Homebrew or MSYS2 prefix the

# headers and libraries were installed under, which follows from the OS and the

# architecture and not from this box — hence the split from the three above,

# and hence a value shared across that whole machine class.

[[machine_lines]]

file = ["~/.stack/config.yaml", "%APPDATA%/stack/config.yaml"]

match = { key_path = [

"extra-include-dirs",

"extra-lib-dirs",

] }

scope = "platform"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/stack. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out. None of them splits local-bin-path and local-programs-path for you — that part is Otty’s own sync, or a template you write by hand.