Platform Engineering

OSX improved (Update)

By

Updated May 17, 2024 to fit M* architecture

My favorite development environment on my MacBook includes an improved Zsh shell and an extended .vimrc configuration file with syntax highlighting, error checking, TextMate snippets, and the Solarized color scheme. 

Here's a guide for setting up similar features:  The features include directional key navigation for directories and files, developer-friendly colors, command highlighting, improved history search, auto-complete for options and SSH connections (if keys are known), and many more useful enhancements.  

Get Xcode:
 AppStore => Xcode => Install Xcode

From now we use a terminal window.

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

Install git and wget:
 brew install git
 brew install wget


Install oh-my-zsh:
 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

The script want to change your shell from /bin/bash into /bin/zsh, here you have to provide your password.

To change the theme edit ~/.zshrc and edit line 8:
 ZSH_THEME="YOUR_FAV_THEME"

Install and enable zsh-highlighting:
 git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
 edit .zshrc and add it to the plugins=( ... ) list (space separated):
  zsh-syntax-highlighting

Solarized and Pathogen
(https://ethanschoonover.com/solarized)
(https://github.com/tpope/vim-pathogen)

mkdir -p ~/.vim/autoload ~/.vim/bundle; \  
curl -LSso ~/.vim/autoload/pathogen.vim \
    https://tpo.pe/pathogen.vim

 
cd ~/.vim/bundle
 git clone https://github.com/altercation/vim-colors-solarized.git


Extended .vimrc:
cd ~/ && git clone https://github.com/ikaros/vim-configuration.git && rm -rf .vim && mv vim-configuration .vim && rake -T && rake place_vim_config

I remove some bundles for now:
 git rm --cache bundle/cucumber
 git rm --cache bundle/rubytest
 git rm --cache bundle/snipmate

and add snipmate, because the bundle above does not work:
 git submodule add https://github.com/msanders/snipmate.vim.git bundle/snipmate

update all bundles:
 git submodule update --init

To change the Solarized theme edit in your .vimrc the background-variable (set background=light | dark)

Finished. Enjoy your new shell!

Coding languages

Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Golang: 
Download the binaries from https://go.dev/dl/
Sometimes I got into some trouble installing / updating Go, here's snippets to do so:
https://gist.github.com/gsrai/09bfc7db6548aecfbeacdcd89dcd0720

Additional tools I recommend

iTerm (terminal replacement)
VSCode (M* Apple Silicon)
Chrome
CrossOver (for gaming / windows applications)
Docker Desktop
Onyx (edit hidden OSX settings)

Tweaks

Apple Mail

Smart inboxes => filter for over x years old to clean up old mails, or filter for "unsubscribe" to get rid of spam and unwanted mails.

More infos about tuning mail.app to fit your need in that apple knowledgebase article 

Finder

Open finder, press "Apple + ,", here are my tweaks:
=> General: Open folders in tabs .. [X]
=> Tags: Add new tags to find docs, like "work", "private" etc
=> Sidebar: Select what you want to see in the finders' sidebar
=> Advanced: See screenshot 


Thats all, leave a comment when you have more tweaks everyone should know about ;)

Need help with distributed systems, backend engineering or data platforms? See my consulting services.

Alexander Alten

Alexander Alten

Founder of Scalytics, co-creator and PMC member of Apache Wayang, and author of KafScale. I write about Kafka, streaming, data platforms, IoT and AI agent infrastructure in production.