To setup the dotfiles just run one of the following snippets in the terminal:

That's it! ✨

The setup process will:

• Download the dotfiles on your computer (by default it will suggest ~/projects/dotfiles)
• Create some additional directories
• Symlink the git, shell, and vim files
• Install applications / command-line tools for OS X / Ubuntu
• Set custom OS X / Ubuntu preferences
• Install vim plugins

OS X	Ubuntu

OS X	Ubuntu

OS X	Ubuntu

OS X	Ubuntu

OS X (MacVim)	Ubuntu (Gnome Vim)

The dotfiles can be easily extended to suit additional local requirements by using the following files:

If the ~/.bash.local file exists, it will be automatically sourced after all the other bash related files, thus, allowing its content to add to or overwrite the existing aliases, settings, PATH, etc.

Here is a very simple example of a ~/.bash.local file:

#!/bin/bash

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

# Set local aliases

alias starwars="telnet towel.blinkenlights.nl"

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

# Set PATH additions

PATH="/usr/local/bin:$PATH"
PATH="$PATH:$HOME/projects/dotfiles/bin"

export PATH

If the ~/.gitconfig.local file exists, it will be automatically included after the configurations from ~/.gitconfig, thus, allowing its content to overwrite or add to the existing git configurations.

Note: Use ~/.gitconfig.local to store sensitive information such as the git user credentials, e.g.:

[user]
    name = Cătălin Mariș
    email = [email protected]

If the ~/.vimrc.local file exists, it will be automatically sourced after ~/.vimrc, thus, allowing its content to add or overwrite the settings from ~/.vimrc.

Same as ~/.vimrc.local but for ~/.gvimrc.

If you decide to fork this project, don't forget to substitute my username with your own in the setup snippets and in the dotfiles script.

To update the dotfiles you can either run the dotfiles script or, if you want to just update one particular part, run the appropriate os script.

Inspiration and code was taken from many sources, including:

• Mathias Bynens' dotfiles
• Nicolas Gallagher's dotfiles

The code is available under the MIT license.