This repository contains packages for setup and maintenance of a developer environment across Mac computers. While this is my preferred setup, which includes some base packages needed for a development, any packages can be removed or added to to fit any need.
Dotfiles supports Intel and M1 Macs!
If you're new to using dotfiles and have a fresh Mac, continue on. If you're migrating from a Time Machine backup, jump to here
These dotfiles use zshell, Homebrew to manage packages, and nvm (which is installed separately from brew).
When performing the install, dotfiles will check for the existance of these packages and install them before Homebrew installs any packages.
Packages installed by Homebrew include:
- Helpful and powerful cli and Mac utilities
- Ideal apps and tools for developer enablement
- Additional and supported fonts
- And some additonal App Store-specific applications
Note: not all packages are needed and can be modified in the Brewfile. To add more packages, look up the correct package name in Homebrew's available formulaes
These instructions are for when you've already set up your dotfiles. If you want to get started with your own dotfiles you can find instructions below.
First, go through the checklist below to make sure you didn't forget anything before you wipe your hard drive.
✅ Did you commit and push any changes/branches to your git repositories?
✅ Did you remember to save all important documents from non-iCloud directories?
✅ Did you save all of your work from apps which aren't synced through iCloud?
✅ Did you update mackup to the latest version and run mackup backup?
Follow this article to cleanly install the latest macOS version.
Follow these steps to setup a new Mac:
- Update macOS to the latest version with the App Store
- Install Xcode from the App Store, open it and accept the license agreement
- Install macOS Command Line Tools by running
xcode-select --install - Copy your public and private SSH keys to
~/.sshand make sure they're set to600 - Clone this repo to
~/.dotfiles - Run
fresh.shto start the installation - After mackup is synced with your cloud storage, restore preferences by running
mackup restore - Restart your computer to finalize the process
Your Mac is now ready to use!
Note: you can use a different location than
~/.dotfilesif you want. Just make sure you also update the reference in the.zshrcfile.
These instructions are for when you want to migrate from an older backup. This assumes that you have a pre-existing Homebrew install or development setup with some existing apps and packages.
If you're like me and have a Time Machine backup from an Intel Mac, you can still perform a migration on an M1 Mac, but Homebrew will be installed in the wrong location.
Intel Macs should have Homebrew installed at this location:
$ which brew # /usr/local/HomebrewFixing the old install is quite simple with the following steps:
- Uninstall Homebrew
- Remove any leftover files
Cask,Cellar, andFrameworksunder/usr/local/ - Reinstall Homebrew
Removing the old files won't be an issue because Homebrew installs metadata for packages it installs at those locations and won't affect already installed packages. You will notice several failures for packages already installed.
M1 Macs should have Homebrew installed at this new location:
$ which brew # /opt/homebrewReferences:
Original blog about Dotfiles and how to create your own can be found in Dries Vints' dotfiles. I originally followed his work and added my own flavour.
Note: His dotfiles uses a LAMP stack setup, but I stripped those down for my own general use. Any additions will most likely become extensions in branches/tags for other stacks (MEAN, JAM, etc).