1. Install iTerm2

iTerm2 is a terminal emulator that provides advanced features compared to the default Terminal app.

1. Visit the iTerm2 website and download the latest version.
2. Open the downloaded zip file and drag the iTerm app into your Applications folder.
3. Launch iTerm2 from your Applications folder or via Spotlight.

2. Accept Xcode License Agreement

Xcode is required for development tools. You must accept its license agreement:

sudo xcodebuild -license accept
            

You may be prompted to enter your password. Once accepted, proceed with the next step.

3. Install Homebrew

Homebrew is a package manager that simplifies software installation on macOS.

1. Open iTerm2.
2. Run the following command to install Homebrew:

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

3. Follow the on-screen instructions to complete the installation.

4. Install Git

Git is a version control system used for managing source code.

1. Open iTerm2.
2. Run the following commands to update Homebrew and install Git:

   brew update && brew install git
                       

3. Verify the installation by running:

   git --version
                       

5. Install Docker Desktop

Docker Desktop is used for containerized development environments.

1. Visit the Docker Desktop website and download the appropriate version for your machine (Intel or Apple Silicon).
2. Open the downloaded .dmg file and drag the Docker app into your Applications folder.
3. Launch Docker Desktop and follow the on-screen instructions to complete the installation.
4. Configure Docker:
   • Open Docker Desktop Preferences.
   • Under "File Sharing Implementation for Containers," select VirtioFS.
   • If you are on Apple Silicon, check the "Use Rosetta for x86/amd64 emulation" option.
   • Click Apply & Restart.

6. Set Up Directories

Organize your projects with the following directories:

mkdir -p ~/src/ke
            

7. Install and Set Up Dotfiles

Kalkomey provides a set of dotfiles to configure your development environment.

1. Clone the dotfiles repository:

   git clone https://github.com/kalkomey/dotfiles.git ~/.dotfiles
                       

2. Run the bootstrap script:

   cd ~/.dotfiles
   script/bootstrap
                       

3. Run the install script:

   script/install
                       

Your environment is now configured with Kalkomey's dotfiles.