This is a collection of dotfiles that should make your day to day work easier, if you see any errors or wish to contribute feel free to fork, open an issue or send a pull request.
We try to keep installing as simple as possible by keeping the steps to a minimum and our dotfiles as backward compatible across the couple of OS we use the most.
We provide a simple online installer, if you're running Ubuntu, Debian or OSX, it will automatically try to resolve dependencies, install rbenv, install homebrew or linuxbrew depending on the OS you're running; if your OS is not supported you can still resolve dependencies and generate the files manually.
curl https://raw.githubusercontent.com/cloverinteractive/dotfiles/master/install | sh
Check our developers section of this README to learn how to run the installer in a virtual machine.
If you want to resolve dependencies on your own, you can install by doing a simple github checkout.
# We like to keep dotfiles somewhere in $HOME but you can clone anywhere you have permission to git clone https://github.com/cloverinteractive/dotfiles.git ~/.dotfiles cd ~/.dotfiles bundle install rake
Your original dotfiles will be renamed to
name.orig so you can always restore them.
Our uninstall script is still a work in progress, to run it simply do run the uninstall task from your dotfiles folder.
Afterwards you can optionally
rm -fr ~/.dotifiles if you wish, your
name.orig files will be restored by having run
Only if you don't run the
install script provided
gem install bundler
Upgrade single bits
If you already have dotfiles installed (all symlinks have been created) you can upgrade small bits like this:
cd ~/.dotfiles git pull rake bash # bash being the bit you wish to upgrade
If you don't know what bits are available in dotfiles; simply run
rake -T for a full list of tasks.
Commands that will make this enjoyable
These dotfiles include configuration tweaks for:
To get most of these dotfiles we recommend installing these packages
Homebrew makes managing and installing packages in both Linux and OSX pretty simple. This is not required for Linux since most distributions have a pretty robust package manager;
hoewever homebrew allows you to install packages directly into
$HOME without special permissions, and in many cases unavailable or newer packages that your OS package manager does
You can install each of this with a simple
brew install <package>.
If you're on a mac we highly recommend using Homebrew, it's constantly getting updates and it's pretty clean and easy to manage, here's a list of packages you should be looking to install.
If you're using linux and would like to install packages to your
$HOME then Linuxbrew is a simple way to get this done, like homebrew it gets
frequent updates and it's pretty clean and easy to maintain, not to mention it has formulas for many of the same packages homebrew does, should a package not be present it's only a matter
of falling back to the OS package manger.
We try to make development as simple as possible for ourselves, therefore we've worked in a way of easily running our scripts in a virtual machine that we can use a sandbox our installer can be ran from vagrant.
To start playing with our setup you'll need vagrant and virtualbox, you can use hombrew's
brew cask install vagrant virtualbox in
OSX if you already have homebrew installed or download the installers provided for your OS in both of the official sites.
git clone https://github.com/cloverinteractive/dotfiles.git cd dotfiles # This will run vagrant in the background and setup a test box or boot it if you already have one vagrant up # This will connect you to your new virtual machine via ssh vagrant ssh
Once in vagrant, your project folder will be synced into your VM's
/vagrant folder, that means you do not need to exit ssh to make changes or disconnect if you do change something in your OS;
You can run the installer from
/vagrant and even pass it the name of the branch to install like this:
# Run installer from the /vagrant folder /vagrant/install features/my-cool-feature # Log out and log back in or load ~/.bash_profile source ~/.bash_profile
When you're done you can shutdown vagrant by running
These dotfiles are still in the works and are not perfect, feel free to advise, fork and send your pull requests.