Dotfiles setup recommendations

readme.md

How to setup a git repo for your dotfiles

For general guidance follow this great write up: https://www.atlassian.com/git/tutorials/dotfiles

In summary:

On the main computer:

git init --bare $HOME/.cfg
alias dotfiles='/usr/bin/git --git-dir=$HOME/.cfg/ --work-tree=$HOME'
dotfiles config --local status.showUntrackedFiles no
echo "alias config='/usr/bin/git --git-dir=$HOME/.cfg/ --work-tree=$HOME'" >> $HOME/.bashrc

To add some files

dotfiles status
dotfiles add .vimrc
dotfiles commit -m "Add vimrc"
dotfiles add .bashrc
dotfiles commit -m "Add bashrc"
dotfiles push

To add the files to a remote system

cd ~
echo ".cfg" >> .gitignore
git clone --bare <git-repo-url> $HOME/.cfg
alias dotfiles='/usr/bin/git --git-dir=$HOME/.cfg/ --work-tree=$HOME'
dotfiles config --local status.showUntrackedFiles no
dotfiles checkout

Troubleshooting

if you receive an error like this

error: The following untracked working tree files would be overwritten by checkout:
    .bashrc
    .gitignore
Please move or remove them before you can switch branches.
Aborting

You could use:

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

Wrapping up

dotfiles config --local status.showUntrackedFiles no

My dotfiles at the moment:

.aws/config
.gitconfig
.multirc
.oh-my-zsh/custom/aliases.zsh
.oh-my-zsh/custom/example.zsh
.oh-my-zsh/custom/plugins/example/example.plugin.zsh
.oh-my-zsh/custom/themes/example.zsh-theme
.oh-my-zsh/custom/themes/powerlevel10k
.p10k.zsh
.zshrc

Some good examples of dotfiles:

• https://bitbucket.org/durdn/cfg/src/master/
• https://github.com/mathiasbynens/dotfiles
• https://github.com/holman/dotfiles
• https://dotfiles.github.io/inspiration/