DEV Community

Cover image for How to Set Up a Mac for Web Development
Michael Uloth
Michael Uloth

Posted on • Updated on • Originally published at michaeluloth.com

How to Set Up a Mac for Web Development

While you can build basic websites with nothing more than a text editor and browser, you may want to up your game by adding a JavaScript framework like React or Vue and useful tools like Git to your workflow.

But wait! Your Mac isn’t ready. Before diving in, you’ll need to install a few items to that will save you from confusing errors later. 😩

This article will guide you through the minimum setup you'll need to get up and running with JavaScript-based web development on your Mac.

Let’s go!

Update Your Mac

Before installing any new software, follow these instructions from Apple to upgrade macOS and your current software to the latest version.

Choose a Terminal App

Since you'll be interacting with your Mac using the command line in this article, you'll need a terminal app.

Any of the following are good options:

If you aren’t sure which one to pick, choose Hyper.

Command Line Developer Tools

The first thing you'll need to install from the command line are your Mac's command line developer tools. Installing these now will prevent weird errors later.

To check if the tools are already installed, type the following command in your terminal app and hit return:

xcode-select --version
Enter fullscreen mode Exit fullscreen mode

If the result is not a version number, install the tools with this command:

xcode-select --install
Enter fullscreen mode Exit fullscreen mode

A dialog will appear asking if you'd like to install the tools. Click Install and the package will download and install itself.

When the installation finishes, confirm the tools are now installed by rerunning the first command:

xcode-select --version
Enter fullscreen mode Exit fullscreen mode

The result should now be a version number.

Homebrew

Instead of installing the next few tools by going to each tool's website, finding the download page, clicking the download link, unzipping the files, and manually running the installer, we’re going to use Homebrew.

Homebrew is a tool that lets you install, update and uninstall software on your Mac from the command line. This is faster and safer than the manual approach and generally makes your development life easier.

First, check if Homebrew is already installed:

brew --version
Enter fullscreen mode Exit fullscreen mode

If you don't see a version number, install Homebrew with this command:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Enter fullscreen mode Exit fullscreen mode

I promise that's the weirdest command you'll see in this article! 😅 Thanks to Homebrew, the rest are simple.

Before moving on, confirm Homebrew is now installed:

brew --version
Enter fullscreen mode Exit fullscreen mode

Node and npm

Node.js is a tool that allows your Mac to run JavaScript code outside of a web browser. If you want to run a JavaScript framework like React or Vue on your Mac, you’ll need to have Node installed.

Node also includes npm (the Node Package Manager), which gives you access to a giant library of free code you can download and use in your projects.

First, check if Node is already installed:

node --version
Enter fullscreen mode Exit fullscreen mode

If not, install it with Homebrew:

brew install node
Enter fullscreen mode Exit fullscreen mode

Finally, confirm Node and npm are now installed:

node --version
Enter fullscreen mode Exit fullscreen mode
npm --version
Enter fullscreen mode Exit fullscreen mode

Git

Git is a tool that helps you track changes to your code and work with other developers on shared projects.

Using Git on all every project is a great habit to develop and will prepare you for future projects where Git may be required. Some tools (like GatsbyJS) also depend on Git being installed on your Mac, so you’ll need it even if you don’t plan to add it to your workflow.

Once again, start by checking if Git is already installed:

git --version
Enter fullscreen mode Exit fullscreen mode

If not, install it:

brew install git
Enter fullscreen mode Exit fullscreen mode

And confirm the installation worked:

git --version
Enter fullscreen mode Exit fullscreen mode

Update Everything

Once in a while, run the following command and everything you’ve installed with Homebrew will update automatically:

brew update && brew upgrade && brew cleanup && brew doctor
Enter fullscreen mode Exit fullscreen mode

That one command is all you need to keep your system up to date. 🙌 I usually run it when I start a new project, but feel free to do so whenever you like.

(When you run this command, if Homebrew suggests additional commands for you to run, go ahead and run them. If a command begins with sudo and you are prompted for a password, use your Mac’s admin password.)

That’s it for the command line!

Code Editor

While you can write code in any text editor, using one that highlights and validates your code will make your life much easier.

Any of the following are good options:

If you’re just getting started, choose Visual Studio Code.

Browser

As you code, it helps to view the app or website you’re building in a browser to confirm it works. While you can use any browser for this, some include extra developer tools that show you details about your code and how to improve it.

Either of the following are good options:

If you’re just getting started, choose Chrome.

Finder

A quick tip here: you’ll want to show the files your Mac hides by default. (For example, git files are automatically hidden, but sometimes you’ll want to edit them.)

The easiest way to show your Mac’s hidden files is with the keyboard shortcut sh⌘⇧. (Command + Shift + Period). This will alternate between showing and hiding these files so you can access them when you need them.

Conclusion

You're all set! 🎉

That’s all you need to get up and running with JavaScript-based front-end development on your Mac.

To prevent confusion, I left out any items that aren’t strictly required. If you'd like to dive deeper into optional ways you can further customize your Mac for web development, check out the links below.

Further Reading

Top comments (4)

Collapse
 
claire profile image
Claire Martinez

your brew install command is missing a starting quote it should be

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Collapse
 
ooloth profile image
Michael Uloth

Thank you! I'm not sure how I missed that and so glad you caught it.

I've updated the post with starting quote added.

Collapse
 
ramlev profile image
Hasse R. Hansen

Why do you suggest Chrome is good enough if you're new?

Unless you're on a really old mac, git is installed by default.

Collapse
 
ooloth profile image
Michael Uloth

Thanks for the questions!

I suggest Chrome simply because I don't want beginners to get too stuck on the decision. Either browser is great, and experienced devs can choose any browser they like. For anyone who prefers a definitive recommendation, I chose Chrome because of its excellent developer tools and integrated Lighthouse audits.

I haven't found that Git is installed by default on my Macs (e.g. I had to reinstall it after upgrading to Mojave). If you've found that it's there on yours, that's great. I started each step in the article with checking if the tool is already installed - if so, you're good to go!