flyck / mac-dev-playbook

Mac setup and configuration via Ansible.

Mac Dev Playbook

Installation

1. Go to this repo with Safari on the new laptop
2. Ensure Apple's command line tools are installed (xcode-select --install to launch the installer).
3. Install Ansible:
   1. Go to python.org/download and download the python installer. Install manually
   2. Install the SSL certificates for python.

   /Application/Python... /Install\ Certificates.command

   3. Install Ansible: pip3 install ansible
4. Clone or download this repository to your local drive: mkdir git; cd git; git clone https://github.com/flyck/mac-dev-playbook.git
5. Remove all existing dock icons

   defaults write com.apple.dock persistent-apps -array
   killall Dock

6. Run ansible-galaxy install -r requirements.yml inside this directory to install required Ansible roles. They allow automatic installation of homebrew packages and more.
7. Run ansible-playbook main.yml --ask-become-pass inside this directory. Enter your macOS account password when prompted for the 'BECOME' password.
   • Casks might need to be commented out temporarily because of: geerlingguy/mac-dev-playbook#196
   • Then, add brew to your path: export PATH="/opt/homebrew/bin:$PATH"and run brew update.
   • Finally comment then back in, and the ansible playbook should succeed
8. Enable rectangle (the window manager) by starting it manually and giving the systems permissions. Configure it to start on login.
9. Enable stats by opening it once and giving it the appropriate permissions. Configure it to start on login.
10. Restart Chrome and activate all automatically added plugins.
11. Add the users home to the favorites:
    • Press shift-command-G to bring up "go to folder". Select ~
    • Add it to favorites via control-command-T
12. Start emacs and have all the packages installed.
13. Remove the ^Space mac keybinding in the system menu (interferes with emacs keybinding)
14. Install the downloaded font in ~/.fonts by double-clicking it
15. Import the iterm profile on the desktop in iterm and set it as the default. (depends on font)
16. Log into Dropbox
17. Import the bookmarks into chrome from Dropbox

Goals

• Have central homebrew apps automatically installed
  • zsh
  • vscode
  • git
• Setup iterm2
  • zsh config
  • iterm profile with important settings
  • iterm color schemes
• Git setup
  • git global config
  • setup git/ folder
  • download 6 most recently contributed github projects
• Javascript Dev
  • Node
    • bun install
    • fnm install
    • set an fnm default version (download it)
• Emacs config setup
  • brew install emacs
  • download config
  • ispell
  • ag search
• Dock setup
  • defaults write com.apple.dock persistent-apps -array
  • killall Dock
  • brew install dockutil
  • dockutil add emacs ...
• Chrome addons
• Wallpaper

Special Thanks

Thanks to the inspiration and underlying ansible roles from geerlingguy's mac-dev-playbook.