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
• 🛠 Prerequisites
• 🧰 Setup
  • ✅ Installation Steps
  • 🎨 Styling: Solarized everywhere
• 📚 Usage
  • 🧪 Dev Env
    • TypeScript / Node / React / React Native
    • Python
    • IDE / Text Editors
  • 🔖 Aliases
  • 🛠 Tooling: cool stuff to use
• ❤️ Acknowledgments

---

🎯 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

   source ~/.zshrc

6. Configure Powerlevel10k

   p10k configure

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

• iTerm2 - Terminal
• Oh My Zsh – Zsh configuration framework
• Powerlevel10k – Zsh prompt theme
• Solarized Dark theme - Precision color palette
• Zsh plugin: zsh-autosuggestions, fast-syntax-highlighting