Skip to main content

​
Prerequisites

Before setting up the Maybern development environment, you need to install several foundational tools. This guide walks you through the initial setup for macOS.
All commands in this guide assume you’re using macOS with an Apple Silicon (M1/M2/M3) processor. Paths may differ slightly for Intel Macs.

​
Install XCode Command Line Tools

XCode command line tools provide essential development utilities including Git, compilers, and other build tools. 
xcode-select --install
A dialog will appear asking you to install the tools. Click “Install” and wait for the installation to complete.

​
Install Homebrew

Homebrew is the package manager for macOS that you’ll use to install most dependencies. 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Oh My Zsh provides helpful shell enhancements and plugin management. 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
Oh My Zsh installation wipes out PATH modifications made by the Homebrew installer. Make sure to add Homebrew back to your PATH after installation.

​
Add Homebrew to PATH

After installing Oh My Zsh, add Homebrew back to your shell configuration: 
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

​
Install Brew Dependencies

Navigate to the backend/ directory and install all dependencies from the Brewfile: 
cd backend
brew bundle install
This installs all required system dependencies including:
  • PostgreSQL 13
  • Redis
  • Python build dependencies
  • Various development tools
Verify the installation by running brew list to see all installed packages.

​
Next Steps

With prerequisites installed, you’re ready to set up the backend and frontend:

Backend Setup

Set up PostgreSQL, Python, uv, and the Django application.

Frontend Setup

Set up Node.js, pnpm, and the React application.