Skip to content

kevinpapst/mac-os-setup

Repository files navigation

MacOS developer setup - dotfiles and software

This is a not only a simple .dotfiles repo from a PHP developer but also a bunch of scripts to create a full featured working environment for myself.

I had the idea to combine my dotfiles repo with the installer functionality after writing my guide Developer setup for Mac OS X 10.11 El Capitan

Be careful: it was never meant to run with any other OS, so don't try it!

What is included?

Its a backup and "out-of-the-box setup" for my working environment. Well, at least for everything that is possible to be setup in an automated way.

That repo was mainly written to share my learnings and quickly become productive on a new machine. I also hope that you will use it as an inspiration for your own environment. Its fun for me to play around with this setup and improve my tooling and workflow, so this repo might get changed quite often.

Main files and folder:

  • atom/ - my atom settings, will be linked to ~./atom
  • bin/ - helper scripts and binaries
  • dotfiles/ - every file in here will be copied to your HOME (~) directory
  • installer/ - some basic software installer, that can't be fetched by Homebrew
  • iterm2/ - my iTerm2 configuration, files will be linked via MacOS configuration (manual restart iTerm2 afterwards)
  • settings/ - installer scripts for settings
  • Brewfile - all the brew repos that will be watched and the software to be installed

Adjust to your needs

Make sure that you checked the following points before you run the installer:

  • Remove any file from installer/ that you don't need
  • Carefully read and adjust Brewfile to only install the software you need
  • Make sure that the .macos settings are thoroughly reviewed
  • Adjust your Git credentials and GitHub settings in settings/git.sh
  • add the file ~/dotfiles/.local or ~/.bash_local for all your sensitive local settings

Installation

You will be prompted during each installation step for your permission. But a word of warning nevertheless: create a backup of your dotfiles and/or your environment first!

git clone https://github.com/kevinpapst/mac-os-setup.git ~/dotfiles

If you don't want to install to ~/dotfiles/ you MUST search for that string and replace it in some files!

Installation (as well as updating later on) is as simple as calling install.sh:

cd ~/dotfiles/
./install.sh

If oh-my-zsh interupts the installation by changing the shell, simply enter exit and you will get back to the installation flow. After the istallation is finished, restart your terminal/iTerm2.

Roadmap ...

This repo is missing a lot of cool things, so my roadmap has at least the following stuff on it:

  • Support for custom zsh configs and plugins at zsh/*.zsh
  • Powerlevel9k
  • Keep PHPStorm setting in repo
  • Solarized color scheme for PHPStorm
  • Test and add oh-my-zsh plugins: colored-man colorize github jira vagrant virtualenv osx zsh-syntax-highlighting fabric node npm history git-flow

Applications that need to be instaled manually

  • Etcher (burn SD images)
  • Monosnap (App Store)
  • XCode (App Store)
  • Spark

Inspired by ❤