Dot Files

Version managed portable development environment configuration for JS/TS devs on OSX.

Important

This repo contains no personal data or secrets, but some configs are specific to our org and developer tooling. For example, it has some opinionated usage of AWS SSO and cert bundles.

All modules are linked in .zshrc and can be disabled to choose which to apply.

Setup

Install PREREQUISITES before executing install script
Follow INSTALL instructions to clone and install default tools
Assign SECRETS required for shell configuration
Setup ASDF for multiple language and version support
Configure AWS SSO profiles for authenticating with AWS
Create KEYS for SSH and GPG access to git cloud providers

Updating

Home Configs

When installing a new tool that reads configuration from $HOME:

Create folder for configs: mkdir $DOTFILES/my-new-tool
Move any default configs: mv $HOME/my-new-tool-config $DOTFILES/my-new-tool
Stow to link back to home: stow -v -t $HOME -d $DOTFILES -S my-new-tool

Shell Configs

When adding a new environment module (any custom shell configs, functions, alias etc):

Create (and edit) code: touch $DOTFILES/environment/my-new-module.sh
Start a new terminal session or run zsh to initialise in place

Brew Bundles

After adding a new package to brewfile, run brew bundle install --file=$DOTFILES/brewfile

All Changes

Commit and push any changes above to save for future installs.

Re-running install script will also reload modules . $DOTFILES/install.sh