Skip to content
Ryan Parman edited this page Nov 3, 2024 · 8 revisions

This guide is intended to go over the fundamentals of preparing your Mac for developing software. It is meant to be beginner-ish, but also goes deeper into certain contexts for more intermediate and advanced topics. These will be marked.

Prerequisites

  • A relatively recent version of macOS. Apple generally provides support for the 3 most recent macOS releases, and we get new releases every Sept/Oct.

    Finder icon
  • You know how to find/launch apps on your Mac. Spotlight is a great built-in tool for this ( space). Third-party software like Alfred, Raycast, or Launchbar are also good tools.

    Spotlight icon
  • You know how to launch your Terminal. The default Terminal (also known as Apple Terminal or Terminal.app) is solid and easy to get started with. As you level-up your Terminal skills, you may want to look at alternative terminals. See Choosing a Terminal for more information.

    Terminal icon

Conventions used in this guide

Terminal

In a block of commands, the $ symbol indicates the command line, but it is not something you type — it is simply a way to let you know that the command after the $ is what you type.

For example, if you see the following…

$ echo "Hello world!"
Hello world!

…it means that you type echo "Hello world!", and the output of the command is Hello world!.

Brand new to this?

Every Mac-based developer should have these installed, full-stop. If you have an alternative setup, you should know how to translate instructions from the below list to whatever your custom setup is.

  1. Updating macOS
  2. Determining your shell
  3. Installing the Xcode CLI Tools
  4. Installing Homebrew