A minimal dotfiles template for OpenBoot, using GNU Stow via a
Makefile
- Click "Use this template" above to create your own dotfiles repo
- Clone your new repo and customize the configs
- Deploy with Make (calls stow internally):
git clone https://github.com/YOUR_USERNAME/dotfiles ~/.dotfiles cd ~/.dotfiles make install
dotfiles/
├── git/
│ └── .gitconfig # Git configuration
├── ssh/
│ └── .ssh/
│ └── config # SSH configuration
├── zsh/
│ └── .zshrc # Zsh configuration
└── README.md
The Makefile calls GNU Stow to create symlinks in $HOME:
| Source | Target |
|---|---|
git/.gitconfig |
~/.gitconfig |
ssh/.ssh/config |
~/.ssh/config |
zsh/.zshrc |
~/.zshrc |
Each top-level directory is a "stow package." OpenBoot detects the Makefile and runs make install automatically — so your repo controls its own deployment logic.
- Go to openboot.dev/dashboard
- Create a config and set your dotfiles repo URL
- Run your custom install command:
curl -fsSL https://openboot.dev/YOUR_USERNAME/CONFIG_SLUG | bash# After running OpenBoot git clone https://github.com/YOUR_USERNAME/dotfiles ~/.dotfiles cd ~/.dotfiles make install
mkdir -p tmux echo "set -g mouse on" > tmux/.tmux.conf stow -v --target="$HOME" tmux # Creates: ~/.tmux.conf
mkdir -p nvim/.config/nvim touch nvim/.config/nvim/init.lua stow -v --target="$HOME" nvim # Creates: ~/.config/nvim/init.lua
mkdir -p alacritty/.config/alacritty touch alacritty/.config/alacritty/alacritty.toml stow -v --target="$HOME" alacritty # Creates: ~/.config/alacritty/alacritty.toml
| Package | Files |
|---|---|
tmux/ |
.tmux.conf |
nvim/ |
.config/nvim/init.lua |
alacritty/ |
.config/alacritty/alacritty.toml |
starship/ |
.config/starship.toml |
wezterm/ |
.config/wezterm/wezterm.lua |
- Backup first: Stow won't overwrite existing files. Move them to
*.backupfirst. - Dry run: Use
stow -n -vto preview changes without applying. - Unstow: Use
stow -D packageto remove symlinks. - Restow: Use
stow -R packageto refresh symlinks after changes.
- openboot - CLI tool
- openboot.dev - Website
MIT