dotfiles-Arch

OS-native Stable

Rolling-release Arch. pacman + AUR + multilib, with a bare-metal stage-0 SETUP guide for a minimal install.

Highlights

  • pacman + AUR
  • multilib + mirrors
  • stage-0 SETUP.md
  • rolling release

How it fits

The OS-native layer — Package manager, paths, clipboard — what changes with the OS. It builds on Core, which is vendored into its core/ directory. See the three-layer model for how the layers compose.

Getting started

git clone https://github.com/dotgibson/dotfiles-Arch ~/dotfiles-Arch
cd ~/dotfiles-Arch
./bootstrap.sh
exec zsh

A fresh/minimal Arch box needs stage-0 groundwork first (user, sudo, git, UTF-8 locale) — see the Arch stage-0 setup guide. Flags: --links-only, --no-flatpak.

What actually bites

  • Never partial-upgrade — pacman -Sy <pkg> without -u can pull a package built against newer libraries than your un-upgraded system and break things. bootstrap always does a full -Syu; the shell layer exposes only pacu (full -Syu), never a -Sy <pkg> alias.
  • Everything is in the official repos — eza/bat/fd/… plus starship, atuin, yazi, mise, and lazygit all live in core/extra — Fedora installs the last five from upstream; Arch just pacman -S’s them. The cleanest distro for this stack.
  • The AUR is not automated — Arch ships no AUR helper. Build paru once and the aur/aurs/auru aliases in os/arch.zsh light up. multilib (32-bit / Wine) is opt-in — uncomment [multilib] in pacman.conf yourself.
  • No transaction undo — pacman has no dnf history undo; recover by reinstalling an older build from the cache — pacdowngrade <pkg> lists cached versions, then pacman -U.

Read next

View dotfiles-Arch on GitHub ↗