My Dotfiles

General Philosophy

I want my configuration to be:

• Simple: Everything should be organized, easy to understand, and easy to modify.
• Minimal: When possible, don't add extra tools that aren't regularly used. Installing an entire plugin manager for one plugin is probably overkill.
• Portable: This repository should be able to be used on any machine, so use tools that are cross-platform and, when not possible, make it easy to pick and choose which are used on which system.

Structure

• files: Contains all the files that will be symlinked to the home directory.
• scripts: Contains the install scripts that can be used to automatically install the configuration.

Shell structure

zsh

• .zshenv sets environment variables that should be available to all zsh invocations, including scripts and non-login, non-interactive shells.
• .zshrc loads individual configuration modules. It has variables to set the order in which modules are loaded.
• .zsh/ is a directory that contains the individual configuration modules. All *.zsh files in this directory are loaded.
• .bin/ is a directory that contains scripts that are added to the PATH. Use this for scripts that are better suited to be stand-alone executables than zsh functions. For example, if they should use set -e or something other than zsh.

bash

Note

I don't use bash as a login or interactive shell, but I keep a minimal bash configuration for compatibility.

• .bashrc sets very basic environment variables so tools using bash can access things like the PAGER, EDITOR, and XDG_CONFIG_HOME.
• .bash_profile simply sources .bashrc.