otty / dotfiles

All tools/pnpm

pnpm

Fast, disk space efficient package manager.

Detected by pnpm, pnpx | macOS, Linux, Windows |pnpm.io

Sync it pnpm.toml

Sync rules

What travels, what stays, what never leaves

Synced6 paths, copied whole to your other machines

~/.config/pnpm/rc

~/Library/Preferences/pnpm/rc

%LOCALAPPDATA%/pnpm/config/rc

~/.config/pnpm/config.yaml

~/Library/Preferences/pnpm/config.yaml

%LOCALAPPDATA%/pnpm/config/config.yaml

Secret fieldsInside a file that otherwise syncs

~/.config/pnpm/rclines starting with

//

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

~/Library/Preferences/pnpm/rclines starting with

//

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

%LOCALAPPDATA%/pnpm/config/rclines starting with

//

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Stays on this machineInside a file that otherwise syncs

~/.config/pnpm/rclines starting with store-dir, global-bin-dir

; pnpm's global rc file: npmrc syntax.

store-dir=/home/octocat/.local/share/pnpm/storemachine-local

global-bin-dir=/home/octocat/.local/share/pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

//npm.pkg.github.com/:_authToken=ghp_FAKE0000000000000000000000000000000000

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/Library/Preferences/pnpm/rclines starting with store-dir, global-bin-dir

; pnpm's global rc file: npmrc syntax.

store-dir=/Users/octocat/Library/pnpm/storemachine-local

global-bin-dir=/Users/octocat/Library/pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

%LOCALAPPDATA%/pnpm/config/rclines starting with store-dir, global-bin-dir

; pnpm's global rc file: npmrc syntax.

store-dir=C:\Users\octocat\AppData\Local\pnpm\storemachine-local

global-bin-dir=C:\Users\octocat\AppData\Local\pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded3 paths, state rather than configuration — never uploaded

~/.local/share/pnpm/store/directory

~/Library/pnpm/store/directory

%LOCALAPPDATA%/pnpm/store/directory

Not a subtraction from the paths above: this is everything else pnpm writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

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

; pnpm's global rc file: npmrc syntax.

store-dir=/home/octocat/.local/share/pnpm/storemachine-local

global-bin-dir=/home/octocat/.local/share/pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

//npm.pkg.github.com/:_authToken=ghp_FAKE0000000000000000000000000000000000

…

Each machine keeps its own copy of these.

//

Lifted into your secret store; the rest of the file syncs.

· config.yaml Sync

; pnpm's global rc file: npmrc syntax.

store-dir=/Users/octocat/Library/pnpm/storemachine-local

global-bin-dir=/Users/octocat/Library/pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

Each machine keeps its own copy of these.

//

Lifted into your secret store; the rest of the file syncs.

· config.yaml Sync

· pnpm/store/ Exclude

· ~/.local/share/pnpm/store/ Exclude

; pnpm's global rc file: npmrc syntax.

store-dir=C:\Users\octocat\AppData\Local\pnpm\storemachine-local

global-bin-dir=C:\Users\octocat\AppData\Local\pnpmmachine-local

registry=https://registry.npmjs.org/

//registry.npmjs.org/:_authToken=npm_FAKE00000000000000000000000000000000

Each machine keeps its own copy of these.

//

Lifted into your secret store; the rest of the file syncs.

· config.yaml Sync

· store/ Exclude

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

apps/pnpm.tomlThe file this page is generated from

id = "pnpm"

name = "pnpm"

homepage = "https://pnpm.io"

description = "Fast, disk space efficient package manager."

icon = "theSVG:pnpm"

# `pnpx` is pnpm's own shorthand for `pnpm dlx`, shipped by the same package.

detect = ["pnpm", "pnpx"]

# https://pnpm.io/cli/config — the global configuration file is

# $XDG_CONFIG_HOME/pnpm/rc when that variable is set, otherwise

# ~/.config/pnpm/rc on Linux, ~/Library/Preferences/pnpm/rc on macOS and

# ~/AppData/Local/pnpm/config/rc on Windows. The same page gives the same four

# locations for config.yaml, the YAML settings file, and

# https://pnpm.io/settings adds that settings such as hoistPattern, nodeLinker

# and shamefullyHoist "must be configured in pnpm-workspace.yaml or the global

# ~/.config/pnpm/config.yaml".

# ~/.npmrc is not listed here: pnpm reads it, but it is npm's file and the npm

# entry already describes it.

paths = [

"~/.config/pnpm/rc",

"~/Library/Preferences/pnpm/rc",

"%LOCALAPPDATA%/pnpm/config/rc",

"~/.config/pnpm/config.yaml",

"~/Library/Preferences/pnpm/config.yaml",

"%LOCALAPPDATA%/pnpm/config/config.yaml",

]

# https://pnpm.io/settings — the default storeDir is $XDG_DATA_HOME/pnpm/store,

# ~/.local/share/pnpm/store on Linux, ~/Library/pnpm/store on macOS and

# ~/AppData/Local/pnpm/store on Windows. Content-addressed package storage, not

# configuration.

# Three literal spellings, because no base directory names this set: the macOS

# store is ~/Library/pnpm — `pnpm store path` prints it — which is neither

# [dataHome]'s ~/Library/Application Support nor [xdgData]'s ~/.local/share.

# So ~/.local/share/pnpm/store is the Linux line alone, not a spelling of the

# same directory the other two name.

exclude = [

"~/.local/share/pnpm/store/",

"~/Library/pnpm/store/",

"%LOCALAPPDATA%/pnpm/store/",

]

secret = []

# The rc file is npmrc syntax, and registry auth there is keyed by the registry

# URL, so the key is never the same twice — `//registry.npmjs.org/:_authToken=…`.

# Every one of them starts with `//` and nothing else in the file does. All

# three spellings, or the token is lifted out on Linux and syncs in the clear

# from a Mac or a Windows box.

[[secret_paths]]

file = ["~/.config/pnpm/rc", "~/Library/Preferences/pnpm/rc", "%LOCALAPPDATA%/pnpm/config/rc"]

match = { prefix = ["//"] }

# store-dir and global-bin-dir are absolute paths into this machine's disk —

# a Homebrew prefix, a Linux XDG directory, a drive letter — and pnpm resolves

# them itself when they are absent.

# Since pnpm resolves them itself, a line here is the user's own choice of where

# the store and the global bin live: kept so they can rebuild this machine,

# never applied to the next.

[[machine_lines]]

file = ["~/.config/pnpm/rc", "~/Library/Preferences/pnpm/rc", "%LOCALAPPDATA%/pnpm/config/rc"]

match = { prefix = ["store-dir", "global-bin-dir"] }

scope = "backup"

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/pnpm. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits store-dir and global-bin-dir for you — that part is Otty’s own sync, or a template you write by hand.