joseoc
en
engineering

Setting Up a New Mac: The Complete Developer Guide

A comprehensive, 12-part series on automating and optimizing your macOS development environment for DevOps, AI, and performance.

#macos #setup #guide #devops #automation

Setting up a new development machine can be a daunting task. This series aims to transform that process into a fast, reproducible, and documented workflow. From base system automation to advanced shell customization and infrastructure as code for your dotfiles, this guide covers everything you need to build a premium developer workstation.

Tip

Already have your dotfiles ready? If you have already followed this guide once and just need to set up a brand new Mac, jump straight to Setting Up a New Mac in One Command.

The Foundations

  1. Automating macOS Setup: Homebrew, Brewfile, and Essential CLI Tools The foundation of any modern macOS setup. Learn how to use Homebrew to manage your entire system as code.

  2. Choosing and Configuring the Best Terminal for macOS: Ghostty vs iTerm2 Your terminal is your home. We compare the fastest modern options and set them up for peak performance.

  3. Securing Your Identity: SSH Keys, GPG, and 1Password on macOS Security shouldn’t be a hurdle. Integrate 1Password with SSH and GPG for a seamless, secure workflow.

Productivity & Workflow

  1. Advanced Git Configuration: Productivity, Security, and Global Ignores Go beyond git commit. Configure delta pagers, aliases, and global hooks.

  2. The Modern DevOps Toolkit: Essential CLI Tools for macOS A curated list of modern replacements for legacy Unix tools (ripgrep, fd, bat, and more).

  3. Supercharging Shell Usability: FZF, Zsh Completions, and Modular Config Make your shell feel alive with fuzzy finding and intelligent autocompletion.

  4. Crafting the Ultimate Terminal Prompt with Starship: Fast and Context-Aware The only prompt you’ll ever need. Minimalist, fast, and cross-shell compatible.

Environment & Tooling

  1. Managing Secrets and Environments on macOS: 1Password CLI and Direnv Automate environment variables based on your current directory without leaking secrets.

  2. Modern Python Development on macOS: Fast and Isolated with UV Ditch pip and conda. Learn how uv makes Python development instantaneous and reproducible.

  3. The Cloud-Native Engineer’s Toolkit: Kubernetes, Terraform, and Helm on macOS Setting up the essentials for cloud infrastructure and container orchestration.

Advanced Setup

  1. The Ultimate Neovim Setup for DevOps Engineers: Speed and Precision A deep dive into why Neovim is the ultimate editor for high-performance engineering.

  2. Infrastructure as Code for Your Mac: Managing Dotfiles with Chezmoi The final piece of the puzzle. Synchronize your entire setup across machines using Git and Chezmoi.

What’s Next?

Once you’ve completed this series, your Mac will be a finely tuned instrument. You can find more specific guides in the engineering category or explore my latest posts.