Minimal Dotfiles

A deliberately minimal dotfile configuration.

Philosophy

Over the years I have grown tired of tweaking config files for every component of my desktop. This repository contains only the essentials.

Start with a minimal Void Linux install using the XFCE4 base image.

What's Inside

.
├── config/
│   ├── alacritty/     # Alacritty terminal configuration
│   ├── fish/          # Fish shell configuration
│   ├── kanata/        # Keyboard remapping
│   ├── lf/            # Terminal file manager
│   ├── nvim/          # Neovim setup
│   └── tmux/          # Tmux configuration
├── scripts/
│   ├── install_odin         # Odin compiler install recipe
│   ├── install_php          # PHP install recipe
│   ├── install_raylib_deps  # Raylib dependencies
│   └── install_theme        # XFCE4 theme setup
└── install.sh         # Dotfile symlinks and package installation

Prerequisites

Before running install.sh, take care of the following manually:

• sudo xbps-install -Su — sync and update
• Set up SSH keys
• Clone this repo
• Install a Nerd Font

Software Installation

Installs packages and creates config symlinks on top of the XFCE4 base image.

Install Options

# Interactive mode (prompts for confirmation at each step)
./install.sh

# Only create symlinks
./install.sh -l

# Only install packages
./install.sh -i

What Gets Installed

The script enables void-repo-nonfree (and void-repo-multilib-nonfree on x86_64), then installs packages via xbps-install:

• CLI Tools: wget, curl, git, unzip, fzf, fd, ripgrep, bat, direnv, tree, jq, lf, rsync, pfetch
• Development: base-devel, make, valgrind, tree-sitter-cli, go
• Shell: fish-shell
• Terminal: alacritty
• Keyboard: kanata
• Desktop: polybar, rofi, xdotool, wmctrl
• Fonts: noto-fonts-ttf, noto-fonts-emoji
• Other: ca-certificates, gnupg, fuse

Symlinks Created

Symlink	Target
~/.config/alacritty	./config/alacritty
~/.config/fish	./config/fish
~/.config/kanata	./config/kanata
~/.config/nvim	./config/nvim
~/.config/lf	./config/lf

Scripts

Self-contained recipes for tooling that goes beyond the core install. Each can be run independently:

./scripts/install_odin
./scripts/install_php
./scripts/install_raylib_deps
./scripts/install_theme

These are not run automatically by install.sh — they are opt-in.

---

This setup prioritises stability and simplicity over customisation. Void Linux + XFCE4 + X11 provides a fast, predictable base with minimal moving parts.