Fresh Install (MacOS)

Install Xcode Command-Line Tools

xcode-select --install

Install homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Clone repo

git clone [email protected]:ungoldman/dotfiles.git

Install packages in Brewfile

~/dotfiles $ brew bundle

Add this line to ~/.zshrc

source ~/dotfiles/init.sh

Note: dotfiles are currently configured for zsh, won't work with other shells.

Tools

homebrew

Homebrew enables access to a lot of useful packages in a fairly easy to handle way (it's like apt-get for macOS).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Brewfile

To use the Brewfile in the root of this repo, you need homebrew-bundle.

brew tap Homebrew/bundle
cd $DOTFILES && brew bundle

zsh

Using zsh (use latest: brew install zsh).

Using starship (brew install starship).

Using Hack Nerd Font with Nerd Font Symbols starship preset for maximum icons and legibility.

Completion extensions (via brew):

• zsh-autosuggestions
• zsh-completions
• zsh-history-substring-search
• zsh-syntax-highlighting

Config

private stuff - /sh/private.sh or /sh/_*.sh

The init.sh file at the root of this repo will attempt to source any .sh file in the sh directory. Git will ignore sh/private.sh, as well as any .sh file prefixed with _. Use this to include anything that shouldn't be checked into version control (secrets, device-specific commands & aliases, etc).

/homefiles

A collection of files for your home directory (like .gitconfig, .inputrc, ..).

/prefs

Misc preference files for apps & programs.

/remote

Bash config and miscellaneous goodies for working with remote servers, VPS instances, etc.

License

ISC