README.md

.dotfiles

My dotfiles for macOS and Linux. Just cherry pick the piece of code you totally understand.

_{For the color theme, check arctic}

✨ Contents

🔥 Text Editor

Neovim: [config]

🐚 Shell

Zsh: [config]

• Use Zim to manage Zsh plugins
• The theme is Powerlevel10k

🛠️ Terminal Emulator

Kitty: [config]

Wezterm: [config]

Alacritty: [config]

🪄 Tiling Window Manager

yabai: [config]

skhd: [config]

🗃️ Console File Manager

lf: [config]

vifm: [config]

ranger: [config]

⌨️ Keyboard Customizer

Karabiner-Elements: [config]

🧶 Others

Tmux: [config]

fzf: [config]

My scripts: bin

💡 How I am managing the dotfiles

Using a bare repository. The dotfiles can reside where they are. No symlinks needed.

Initial setup

Create a bare repository to store the history:

git init --bare $HOME/dotfiles

Create an alias in zshrc, tell Git where the history and the working tree live:

alias dot='git --git-dir=$HOME/dotfiles/ --work-tree=$HOME'

Tell Git not to show all the untracked files, otherwise all files under $HOME will be shown when running git status:

dot config status.showUntrackedFiles no

Set up the remote repository for syncing:

dot remote add origin https://github.com/rockyzhang24/dotfiles.git

Done! Now we can manage our dotfiles.

dot status
dot add ~/.config/zsh
dot commit -m "update zsh config"
dot push origin master

Clone to another machine

Clone the dotfiles into a bare repository:

git clone --bare https://github.com/rockyzhang24/dotfiles.git $HOME/dotfiles

Define the alias in the current shell scope:

alias dot='git --git-dir=$HOME/dotfiles/ --work-tree=$HOME'

Backup the stock configuration files that will be overwritten:

mkdir -p .config-backup
config checkout 2>&1 | egrep "\s+\." | awk {'print $1'} | xargs -I{} mv {} .config-backup/{}

Checkout the actual content from the bare repository to $HOME:

dot checkout

Don't show untracked files and directories:

dot config status.showUntrackedFiles no

Done!

Notes

In order for vim-fugitive to recognize this bare repo, the following additional configurations are required:

dot config core.bare 'false'
dot config core.worktree "$HOME"