dotfiles

Version-controlled personal config for keeping shell setup in sync across machines (especially .bash_profile and .zshrc). It also bootstraps a new macOS machine by installing apps, fonts, CLI tools, and global packages.

Management approach

This repo tracks dotfiles in Git and applies them through setup scripts, instead of managing configs manually per machine. Core shell configs are kept aligned, while package/app lists stay declarative in text files.

Setup

Install Xcode Command Line Tools:

xcode-select --install

Clone this repository to ~/.dotfiles:

git clone git@github.com:faustoq/dotfiles.git ~/.dotfiles

Usage

Run the base setup:

~/.dotfiles/install.sh

Run extra setup/configuration:

~/.dotfiles/extra.sh

Package Lists

This repo keeps package lists in plain text files:

• Homebrew formulae: brews/brewlist.txt
• Homebrew casks: brews/casklist.txt
• Homebrew taps: brews/taps.txt
• Mac App Store apps: brews/maslist.txt
• Composer globals: packages/composer.txt
• npm globals: packages/npm.txt