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](/docs/macos-setup-guide/dotfiles-and-reproducibility#5-setting-up-a-new-mac-in-one-command).

## The Foundations

1.  **[Automating macOS Setup: Homebrew, Brewfile, and Essential CLI Tools](/docs/macos-setup-guide/base-system-setup-macos)**
    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](/docs/macos-setup-guide/terminal-setup-macos)**
    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](/docs/macos-setup-guide/ssh-and-authentication)**
    Security shouldn't be a hurdle. Integrate 1Password with SSH and GPG for a seamless, secure workflow.

## Productivity & Workflow

4.  **[Advanced Git Configuration: Productivity, Security, and Global Ignores](/docs/macos-setup-guide/git-and-version-control)**
    Go beyond `git commit`. Configure delta pagers, aliases, and global hooks.

5.  **[The Modern DevOps Toolkit: Essential CLI Tools for macOS](/docs/macos-setup-guide/shell-cli-tooling)**
    A curated list of modern replacements for legacy Unix tools (ripgrep, fd, bat, and more).

6.  **[Supercharging Shell Usability: FZF, Zsh Completions, and Modular Config](/docs/macos-setup-guide/shell-usability-improvements)**
    Make your shell feel alive with fuzzy finding and intelligent autocompletion.

7.  **[Crafting the Ultimate Terminal Prompt with Starship: Fast and Context-Aware](/docs/macos-setup-guide/prompt-and-ux)**
    The only prompt you'll ever need. Minimalist, fast, and cross-shell compatible.

## Environment & Tooling

8.  **[Managing Secrets and Environments on macOS: 1Password CLI and Direnv](/docs/macos-setup-guide/secrets-and-environment-management)**
    Automate environment variables based on your current directory without leaking secrets.

9.  **[Modern Python Development on macOS: Fast and Isolated with UV](/docs/macos-setup-guide/python-and-automation-tooling)**
    Ditch `pip` and `conda`. Learn how `uv` makes Python development instantaneous and reproducible.

10. **[The Cloud-Native Engineer's Toolkit: Kubernetes, Terraform, and Helm on macOS](/docs/macos-setup-guide/kubernetes-and-devops-tooling)**
    Setting up the essentials for cloud infrastructure and container orchestration.

## Advanced Setup

11. **[The Ultimate Neovim Setup for DevOps Engineers: Speed and Precision](/docs/macos-setup-guide/editor-setup-neovim)**
    A deep dive into why Neovim is the ultimate editor for high-performance engineering.

12. **[Infrastructure as Code for Your Mac: Managing Dotfiles with Chezmoi](/docs/macos-setup-guide/dotfiles-and-reproducibility)**
    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](/category/engineering) or explore my [latest posts](/blog).