Dotfiles

At Context, remote pairing is an important part of our workflow. Using a common tools and configs enables a smoother remote pairing process.

Tools

• tmate - Instant terminal sharing
• vim - highly configurable text editor
• gitsh - interactive shell for git
• rcm - dotfile management
• rubocop - syntax checking for ruby
• eslint - syntax checking for javascript
• stylelint - syntax checking for scss
• powerline fonts - Fonts for an awesome vim status bar
• ag/the_silver_searcher - for faster in-project searching
• vundle - Vim package manager

Getting started

1. Clone this repo git clone [email protected]:Context-Travel/dotfiles.git context-dotfiles
2. Install the tools from the above list
3. Create a ~/.rcrc file (NOTE: If you already use rcm for managing your personal dotfiles just added this dir to DOTFILES_DIRS in your existing .rcrc. Also, if you aren't using rcm for your personal dotfiles and you have personal dotfiles rcm is a powerful way to easily manage dotfiles from multiple sources.)
4. Ensure ~/.bin is added to your $PATH

echo 'DOTFILES_DIRS="~/context-dotfiles"' > ~/.rcrc

1. Install the dotfiles

   rcup
   

2. Install Vim Plugins

   :VundleInstall
   

3. Add your own gitconfigs to ~/.gitconfig.local

   [user]
     name = Rebecca Meritz
     email = [email protected]
   [gitsh]
     gitCommand = /usr/bin/hub
   

   (Note: If you are working with exisiting configs you want to might want to mv ~/.gitconfig to ~/.gitconfig.local and then just delete anything you don't need anymore after you run rcup.)

4. Add shared aliases, by sourcing the ~/.sh.d/aliases file in your bash/zsh config

   source ~/.sh.d/aliases

   Optionally add your own aliases to ~/.aliases.local

OSX Specific Instructions

• You will need to specify the full path to the context-dotfiles dir in .rcrc so it should look like:

  DOTFILES_DIRS=/Users/peter_pizza/context-dotfiles
  

• You'll need to install python from homebrew, which should install pip
• You'll need to use pip2 to install python packages (powerline, tmuxp, etc)

Linux specific instructions

• If you're running a terminal inside of gnome you may want to follow these directions for getting the paste buffer to work in a sensible way.

Basic commands

• Start and attach to tmate session: tmatey
• Switch to an api window with C-b 1, C-b 2, etc.
• Switch to an admin window with C-b F1, C-b F2, etc.
• Switch to an WithContext window with C-n 1, C-n 2, etc.
• Deattach from a tmate session C-b d
• Kill from a tmate session C-b K

Vim Configs

We use Vundle to manage plugins for vim. You can find a list of plugins in vim/vundles. You can add more plugins here to share with the team or you can add personal plugins in your own ~/.vim/vundles.local. All config files are in vim/configs. Add personal configs by just adding a new file to the folder. Add shared configs by editing an existing file or adding a new file and commiting it to this repo.

Update your local dotfiles

1. Pull the lastest changes to this repo cd ~/context-dotfile; git pull origin master
2. Run rcup rcup
3. Install the lastest plugins in vim :VundleInstall

Contributing to dotfiles

We use rcm to manage dotfiles. You can find full documation of the tools provided by rcm by running man rcm. When editing dotfiles you can use mkrc to add an existing dotfile to this repo. To edit an existing file you just edit it directly in its installed location. (rcm manages dotfile by creating symlinks). Once your done making your changes, commit them to a branch in this repo and create a PR as normal.

You can use tmuxp load dots to edit them in a tmux session layed out just for this purpose.

Using other editors

If you plan on using another editor alongside vim ensure you setup the appropriate stylechecking plugins using the linters meantioned above in the tool list.