Home Original page

GitHub - hefgi/dotfiles

Cover

Hefgi's Dotfiles — ⚡️ Dev Setup

This repository contains my configuration files and setup scripts for a macOS development environment using iTerm2 + Zsh + Oh My Zsh + Powerlevel10k + Claude Code, tailored for TypeScript / Node.js / React / React Native and Python engineers of the AI era.

📋 Table of Contents

🎯 Goals

  • Fully declarative via Homebrew Bundle (Brewfile)
  • Minimal manual setup steps
  • iTerm2 + Zsh shell setup optimized for developer productivity
  • Powerlevel10k prompt theme
  • Essential Zsh plugins: autosuggestions, fast syntax-highlighting
  • Support for both TS/Node/React stack and Python dev stack

🛠 Prerequisites

  • macOS (Zsh is default shell)
  • Homebrew installed — this will install Xcode command line tools — see brew.sh
  • Oh My Zsh installed — see ohmyzsh/ohmyzsh

🧰 Setup

Warning: If you want to give these dotfiles a try, you should first fork this repository, review the code, and remove things you don’t want or need. Don’t blindly use my settings unless you know what that entails. Use at your own risk!

✅ Installation Steps

  1. Clone this repo

    git clone https://github.com/hefgi/dotfiles.git ~/dotfiles
cd ~/dotfiles

  2. Install everything via Brewfile

    brew bundle --file=Brewfile

  3. Symlink configuration files

    ln -s ~/dotfiles/.zshrc ~/.zshrc
ln -s ~/dotfiles/.gitconfig ~/.gitconfig
ln -s ~/dotfiles/.vimrc ~/.vimrc   
ln -s ~/dotfiles/vscode/settings.json ~/Library/Application\ Support/Code/User/settings.json

  4. Configure Git

    git config --global user.name "Your Name"
git config --global user.email "you@example.com"

  5. Reload your shell

  6. Configure Powerlevel10k

  7. Install last stable Node Version

    nvm install --lts 
nvm alias default 'lts/*

🎨 Styling: Solarized everywhere

I use the Solarized Dark palette across tools for visual consistency.
Set Solarized Dark in:

  • iTerm2 → Preferences → Profiles → Colors → Load Presets… → Solarized Dark
  • VS Code: Install this package and select Solarized Dark
  • Vim: Follow installation instruction here
  • Sublime Text → Preferences → Color Scheme → Solarized Dark
  • Xcode → Preferences → Fonts & Colors → Solarized Dark

📚 Usage

🧪 Dev Env

TypeScript / Node / React / React Native

Use nvm for Node.js version management and Use npm and/or yarn for package management.

Python

Use pyenv to manage Python versions and use pipenv for virtual environments and dependencies.

AI

Claude Code and Cursor installed by default.

IDE

Use VSCode and Cursor as main IDEs. Use Xcode for iOS Development.

Text Editors

Use Vim for terminal editing and Sublime Text for GUI editing.

🔖 Aliases

  • git logx → prints a pretty, colored Git log graph with recent 20 commits.
  • git tree → shows a nice history tree view of the repository - good terminal alternative to GitX GUI
  • ll → quick shortcut for ls -la to list all files in detail (use eza instead if installed).
  • python → always invokes python3 (from Homebrew) so you don’t have to type python3.
  • pip → always uses pip3, so you install packages for Python 3 by default.

🛠 OPTIONAL: Tooling - cool stuff to use

  • yazi – fast terminal file manager with previews
  • bat – modern cat replacement with syntax highlighting, Git integration
  • fzf – fuzzy finder for files, history, Git branches
  • eza – modern ls replacement (icons, Git status)
  • z (or zoxide) – quickly jump between frequently used directories
  • GitX – macOS GUI Git client for visual source-control management - good GUI alternative to git tree

Install everything via Brewfile

brew bundle --file=Brewfile-cool-tools

❤️ Acknowledgments