Everything DotR manages is described in a single config.toml at the
repository root, created by dotr init.
banner = true
[variables]
# ...
[prompts]
# ...
[packages.<name>]
# ...
[profiles.<name>]
# ...
| Field | Type | Default | Purpose |
|---|
banner | bool | true | Print the DotR ASCII banner on commands. Set false for quiet output. |
variables | table | {} | Config-level variables — see Variables. |
prompts | table | {} | Config-level prompts — see Prompts. |
packages | table | {} | Package definitions, keyed by name — see below. |
profiles | table | { default = {} } | Profile definitions, keyed by name — see below. A default profile always exists. |
[packages.nvim]
src = "dotfiles/nvim"
dest = "~/.config/nvim/"
dependencies = ["fonts"]
pre_actions = ["mkdir -p ~/.local/share/nvim"]
post_actions = ["nvim --headless +PluginInstall +qall"]
skip = false
symlink = false
clean = true
ignore = ["*.log"]
[packages.nvim.variables]
THEME = "gruvbox"
[packages.nvim.targets]
work = "~/work-config/nvim/"
[packages.nvim.prompts]
NVIM_TOKEN = "Enter your plugin registry token"
| Field | Type | Default | Purpose |
|---|
src | string | — | Path to the file/directory in the repository. Required. |
dest | string | — | Deployment destination. ~ and template variables are expanded. Required. |
dependencies | list of strings | none | Other packages deployed alongside this one — Dependencies. |
variables | table | {} | Package-scoped variables — Variables. |
pre_actions | list of strings | [] | Shell commands run before deploy — Actions. |
post_actions | list of strings | [] | Shell commands run after deploy — Actions. |
targets | table (profile → path) | {} | Per-profile destination override — Packages. |
skip | bool | false | Excluded from profile-driven (implicit) selection — Packages. |
prompts | table | {} | Package-scoped prompts — Prompts. |
ignore | list of glob patterns | [] | Files excluded from deploy/clean — Ignoring Files. |
symlink | bool | false | Deploy as a symlink instead of a copy — Symlinks. |
clean | bool | true | Remove stray files at the destination — Clean Mode. |
[profiles.work]
dependencies = ["nvim", "git"]
[profiles.work.variables]
GIT_EMAIL = "work@company.com"
[profiles.work.prompts]
WORK_TOKEN = "Enter your work VPN token"
| Field | Type | Default | Purpose |
|---|
dependencies | list of strings | [] | Packages deployed when this profile is active and no --packages is given — Profiles. |
variables | table | {} | Profile-scoped variables — Variables. |
prompts | table | {} | Profile-scoped prompts — Prompts. |
| File | Tracked in git? | Purpose |
|---|
config.toml | Yes | The configuration described above. |
dotfiles/ | Yes | Package sources — the actual file/directory content for each package. |
.gitignore | Yes | Written by dotr init; excludes .uservariables.toml and deployed. |
.uservariables.toml | No | Answers to prompts — secrets live here. |
deployed/ | No | Staging directory for symlinked packages. |