Dotfiles

Personal Ubuntu 24.04 dotfiles and machine setup.

Install

Run:

./install.sh

Include optional apps with:

./install.sh --extras

Stow layout

$HOME/dotfiles/stow/ mirrors $HOME.

For example:

$HOME/dotfiles/stow/.config/kitty/kitty.conf
→ $HOME/.config/kitty/kitty.conf

$HOME/dotfiles/stow/.config/nvim/init.lua
→ $HOME/.config/nvim/init.lua

$HOME/dotfiles/stow/.zshrc
→ $HOME/.zshrc

The entire stow directory is one GNU Stow package.

Add a new app config

For an app whose config lives at:

$HOME/.config/foo/

run:

./scripts/add-stow-config.sh foo

The helper moves it into:

$HOME/dotfiles/stow/.config/foo/

and restows the dotfiles package.

Then commit it:

git add stow/.config/foo
git commit -m "Add foo config"

Restow

The installer restows dotfiles automatically.

Manually:

cd "$HOME/dotfiles"
stow --dir="$HOME/dotfiles" --target="$HOME" --restow stow

Validate

Check shell syntax:

bash -n install.sh
bash -n scripts/*.sh

Verify a managed file:

readlink -f "$HOME/.config/nvim/init.lua"

It should resolve somewhere under:

$HOME/dotfiles/stow/