Install

Clone and run

With gh + auth

gh repo clone zeachco/dotfiles ~/dotfiles && bash ~/dotfiles/setup.sh

or with git clone

git clone git@github.com:zeachco/dotfiles.git ~/dotfiles && bash ~/dotfiles/setup.sh

If you don't have git installed, just download the zip and unpack into your ~/ it will also install and setup git

Update setup

you can just run dotfiles_update and it will reapply all changes and remove deprecated configs if any

Ubuntu special case

For ubuntu, it also installs omakub it's just too good to ignore, other OS manually installs the good parts of omakub that I want there like zellij, nvim, sh utils configs

Supports

• linux debian/arch based (with apt-get such as Ubuntu)
• linux debian/arch based (with pacman such as Manjaroo)
• maxos (with xcode)
• spin cloud debian-based server
• extensible by profile

Includes

How this repo works

The repository uses a profile-based approach for different environments. When you run setup.sh:

1. It automatically detects your operating system and environment (macOS, Arch, Debian, Ubuntu, Termux, etc.).
2. It first runs the common profile which installs the base set of tools and configurations using stow for symlinking configs/ into your $HOME.
3. It then runs the specific profile for your OS (e.g. variants/osx, variants/ubuntu).
4. Profiles use a helper script (utils.sh) to intelligently manage dependencies across OS package managers (apt, pacman, brew, pkg).
5. It safely injects a source hook into your shell's initialization file (~/.bashrc, ~/.zshrc, etc.) to load aliases, variables, and bash functions from .dotfiles_<variant>.
6. You can re-run the setup at any time safely to update or apply new configs.

Programing languages

Uses mise and devbox to control all envs for python, node, rust, go, etc...

Tools

• git config (auto config with email / name / rebase merge mode and vim editor)
• git aliases (ie gco and git co for git checkout) git aliases print the real command
• lunarvim (text editor)
• neovim (text editor)
• ligature nerd fonts
• fzf (fast file searching)
• zellij (terminal multiplexer with session and workspace management)
• g++ compiler

bash functions

• ipp - public ip print
• ipl - local ip print