.
├── 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.