Setup MacOS for Development

Setup MacOS for Development

Various applications and settings I use on MacOS for development, as a web developer.

Photo by Gustavo Espindola
Published
Reading time
6 min read
Topics
Dev tools

Preface

This article is a living document, meaning that when I use something new or need to add something, I will update this article as well.

Last updated: November 4, 2026

When this article was first written, I didn’t know how to quickly set up the applications, configurations, and tools I often use on my MacBook for development. Several times I struggled when I had to use a fresh MacBook according to my needs. Whether it’s provided by the office, after being reset, or a new MacBook.

I even once needed a whole day to configure everything I needed, so I couldn’t be productive right away. Every time I felt everything was complete, when working, it turned out there was something missing, and eventually, my work was disrupted because I had to continue setting up again to work comfortably.

I created this article as a note to make it easier when I have to set up again later. Since I am a Web Developer, most of the applications and configurations I do here will be around JavaScript / NodeJS. So, if you have the same profession as me, I hope this article can be your note too.

Homebrew

Install Homebrew as a package manager on Mac. The installation method for Homebrew is quite clear on its website.

Terminal window
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Desktop Applications

The applications I use are divided into two types: automatic installation via Homebrew and manual installation.

Automatic Installation

After Homebrew is installed, I can continue to install all the applications I need via Homebrew automatically:

Terminal window
brew install --cask betterdisplay cap claude docker-desktop figma ghostty google-chrome imageoptim iterm2 kap logi-options+ notion notion-calendar openvpn-connect postman raycast shottr slack visual-studio-code whatsapp

The command above will install the applications I need, namely:

Program Function
BetterDisplay External Display Manager
Cap Screen Recorder
Claude AI Assistant
Docker Desktop Environment Tool
Figma Design Tool
Ghostty Terminal Alternative
Google Chrome Web Browser
ImageOptim Image Compressor
iTerm2 Terminal Alternative
Kap Screen Recorder
Logi Options+ Logitech Mouse App
Notion Note-taking Application
Notion Calendar Calendar
OpenVPN Connect Client For Using VPN
Postman API Tool
Raycast Launcher
Shottr Screenshot Tool
Slack Communication
Visual Studio Code Code Editor
Whatsapp Whatsapp Desktop

Manual Installation

Because not all applications are available in Homebrew Cask by default, they have to be installed manually.

Program Function
Focus To-Do Pomodoro & Todo App
XAMPP 7.3.33.0 PHP 7.3 + MySQL Runner

Shell

I use Zsh as the main shell. Fortunately, macOS already includes Zsh as the default shell. So, just install Oh My Zsh to get all the plugins I need right away.

Install Ohmyzsh

Terminal window
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Ohmyzsh Plugins

The plugins I often use in ZSH are as follows:

Built-in Plugin

Plugins that are automatically available when installing Ohmyzsh so just activate them

Plugin Function
Alias Finder To find aliases in Shell
Autojump Jump directories in Shell quickly
Git Git command shortcuts
NVM Load NVM and auto-switch Node

External Plugin

Plugins that must be installed separately:

Plugin Function
ZSH Autosuggestions Autocomplete based on history
ZSH Vi Mode Vim-like Shell

After ensuring the Built-in and External Plugins above are installed, we just need to activate the plugins in the ~/.zshrc file:

~/.zshrc
...
zstyle ":omz:plugins:nvm" autoload yes
zstyle ":omz:plugins:alias-finder" autoload yes
plugins=(
git
zsh-autosuggestions
nvm
autojump
alias-finder
zsh-vi-mode
)
# Press "jj" to leave insert mode
ZVM_VI_INSERT_ESCAPE_BINDKEY=jj
...

Don’t forget to reload the ~/.zshrc configuration file:

Terminal window
source ~/.zshrc

I have discussed the plugins above in the article More Productive Coding with Terminal Plugins

Node.js

I choose to install Node.js via Node Version Manager (NVM) so I can easily switch versions, as I often need to switch to older or newer Node versions. Besides that, for the package manager, I use pnpm because it’s fast and saves disk space.

Install NVM & Node.js

Install NVM

Terminal window
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash

Install Latest LTS Node

Terminal window
nvm install --lts

Switch Node Version

Terminal window
nvm install xx.xx && nvm use xx.xx

Then set the newly installed one as the default

Terminal window
nvm alias default xx.xx

Install pnpm

Terminal window
curl -fsSL https://get.pnpm.io/install.sh | sh -

Git

Installation and Configuration of Git

Install

Install Git via Homebrew:

Terminal window
brew install git

After Git is installed, make sure to set up the profile in the global configuration

Terminal window
git config --global user.name "Full Name" && git config --global user.email "emailaddress@mail.com"

GitHub & GitLab CLI

I also use the command line tools of GitHub and GitLab to create pull requests and merge requests without leaving the terminal:

Terminal window
brew install gh glab

Then log in to each of them:

Terminal window
gh auth login
glab auth login

Neovim & Lazygit

Neovim is my terminal editor, and Lazygit is a terminal UI that makes staging, committing, and resolving conflicts much quicker.

Terminal window
brew install neovim lazygit

To make them easier to reach, I add these lines to ~/.zshrc:

~/.zshrc
export EDITOR=nvim
alias vim="nvim"
alias lg="lazygit"

Then tell Git to use Neovim for commit messages:

Terminal window
git config --global core.editor nvim

System Settings

This section I use macOS Tahoe and depends on personal preference…

Desktop & Dock

  • Set “Default web browser” to Google Chrome
  • Disable “Show suggested and recent apps in Dock” to keep the Dock consistent
  • Adjust Dock size to be smaller because the default size is too big for me

Accessibility

  • Open “Pointer Control” > “Trackpad Options”, and set “Dragging Style” to “Three Finger Drag” to drag-and-drop using three fingers.

Trackpad

  • Check “Tap to click” so you don’t always have to press the Trackpad to click

Keyboard

Even though the language I use on the Mac is English, I have to make sure the following settings are off so that every time I write an Indonesian word, the Mac doesn’t try to change it to a word it thinks is correct.

In the “Input Sources” section, click “Edit” then set the following options:

  • Disable “Show Input menu in menu bar”
  • Disable “Correct spelling automatically”
  • Disable “Capitalize words automatically”
  • Disable “Show inline predictive text”
  • Disable “Add period with double-space”
  • Disable “Use smart quotes and dashes”

Misc

Other settings

Quick access to screenshots

  1. Create a folder named “Screenshots” on the Desktop
  2. Press Cmd + Shift + 5. Then click “Options” > “Other Location”
  3. Select the folder created in step 1
  4. Press Esc to exit the screenshot setting
  5. Open Finder, find the “Screenshots” folder on the Desktop, then drag the folder to the Dock
  6. With the folder now in the Dock, right-click on the folder and check “Fan” in the “view content as” section & check “Name” in the “sort by” section

Figure 1: Quick access to screenshots

Found this useful?

Give it a clap, or share it with someone who'd enjoy it too.

Comments