MacOS Dotfiles and system config

📖 Table of contents:

• Prerequisites
• Software
  • Quick Setup with Brewfile
  • Terminal
    • Git
    • ZSH
    • ZSH with Oh My Zsh
• Development
  • Visual Studio Code
• Containerization
  • Docker
  • Docksal
• Hardware
  • Apple keyboard
    • Karabiner
• Troubleshooting

---

Prerequisites

Brew: https://brew.sh/

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

This will install all the essential CLI tools, GUI applications, development tools, and fonts in one command. The Brewfile includes:

Software

Quick Setup with Brewfile

For a streamlined installation of all packages and applications, use the provided Brewfile:

# Download the Brewfile
curl -O https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/main/files/Brewfile

# Install all packages and applications
brew bundle

Terminal

Git

curl https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/main/files/.gitconfig > ~/.gitconfig && \
curl https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/main/files/.gitignore > ~/.gitignore

ZSH

curl https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/main/files/.profile >> ~/.profile

ZSH with Oh My Zsh

Oh My Zsh is a delightful, open source, community-driven framework for managing your Zsh configuration.

Install Oh My Zsh:

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

Install external plugins:

git clone --depth=1 --single-branch --quiet https://github.com/zsh-users/zsh-autosuggestions "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions" 2>/dev/null || echo "zsh-autosuggestions already exists, skipping"
git clone --depth=1 --single-branch --quiet https://github.com/zsh-users/zsh-syntax-highlighting.git "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting" 2>/dev/null || echo "zsh-syntax-highlighting already exists, skipping"

Copy ZSH config:

curl https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/main/files/.zshrc > ~/.zshrc

Oh My Zsh Features:

• Over 200+ plugins and themes
• Auto-completion and syntax highlighting
• Git integration with useful aliases
• Plugin ecosystem for development tools
• Easy customization and theming

Included Plugins:

• git - Git aliases and functions
• aws - AWS CLI completion
• docker - Docker aliases and completion
• nvm - Node Version Manager integration
• python - Python development tools
• brew - Homebrew integration
• macos - macOS-specific utilities
• vscode - VS Code integration
• zsh-autosuggestions - Command suggestions
• zsh-syntax-highlighting - Syntax highlighting

Development

Visual Studio Code

Download config:

cd "$HOME/Library/Application Support/Code/User" && \
curl -O https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/refs/heads/main/files/Library/Application%20Support/Code/User/settings.json -O https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/refs/heads/main/files/Library/Application%20Support/Code/User/keybindings.json -O https://raw.githubusercontent.com/alexander-danilenko/dotfiles-macos/refs/heads/main/files/Library/Application%20Support/Code/User/mcp.json

Note: VS Code extensions are now managed via the Brewfile and will be installed automatically with brew bundle.

Containerization

Docker

https://docs.docker.com/desktop/install/mac-install/

Docksal

https://docksal.io/installation#linux-supported

bash <(curl -fsSL https://get.docksal.io)

Hardware

Apple keyboard

Karabiner

Install Karabiner:

brew install --cask karabiner-elements

• Fix Ukrainian Apple Keyboard rule

Troubleshooting

TBD