dots

dots helps manage a dotfiles repo across different machines. It can create symlinks for config files, install OS packages, start services, copy fonts, and replace setup scripts with checked commands.

Start with the quick start if you are trying dots for the first time. The other pages go deeper into each part of the config.

Start here

• Quick start: create a small setup with symlinks and packages.
• Install: install the dots binary.
• Symlinks: link files from the repo into $HOME.
• Packages: install OS packages with pacman, yay, paru, apt, or Homebrew.
• Services: start and enable background services.
• Commands: replace setup scripts with checked commands.
• Fonts: install fonts stored in the repo.
• User: set the login shell or Linux groups.
• Platforms and profiles: share one repo across operating systems, machines, or profiles.
• Organization: split dots.lua into normal Lua modules.
• State: inspect or forget what dots manages.
• Changelog: see what changed between releases.
• Release: publish a tagged GitHub release.