🛠️ Personal Dotfiles Template

A clean, privacy-conscious dotfiles template for macOS development environments. This template removes personal information while preserving useful configurations.

🔧 What's Included

• Shell: zsh with oh-my-zsh, Powerlevel10k theme, custom aliases
• Git Workflows: Interactive branch creator, PR helper, useful aliases
• Development: Node.js, Docker, Terraform shortcuts
• System Setup: PATH management, environment variables

🚀 Quick Setup

Prerequisites

• macOS with Homebrew installed
• oh-my-zsh (installation guide)

1. Clone and Setup

git clone [YOUR_REPO_URL] ~/Sites/dotfiles
cd ~/Sites/dotfiles

# Backup existing configs
mkdir -p ~/.dotfiles-backup
mv ~/.zshrc ~/.aliases ~/.path ~/.env_vars ~/.dotfiles-backup 2>/dev/null

# Link configuration files
ln -s ~/Sites/dotfiles/.zshrc ~/.zshrc
ln -s ~/Sites/dotfiles/.aliases ~/.aliases
ln -s ~/Sites/dotfiles/.path ~/.path
ln -s ~/Sites/dotfiles/.env_vars ~/.env_vars

2. Install Shell Enhancements

# Install oh-my-zsh plugins
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# Install Powerlevel10k theme
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/themes/powerlevel10k

# Reload shell
source ~/.zshrc

🎨 Key Features

Git Aliases & Workflows:

guma      # Update main branch from origin
gcbr      # Clean merged branches
gpushu    # Push new branch with upstream

Development Tools:

dockerclean    # Clean old containers
brewup         # Update Homebrew
nr             # npm run shortcut
tf             # Terraform shortcut

Navigation:

cl             # Clear and list
cdev           # Quick cd to Development
cdocs          # Quick cd to Documents

📁 Structure

dotfiles/
├── .aliases              # Command shortcuts and functions
├── .env_vars             # Environment variables
├── .path                 # PATH modifications
├── .zshrc                # Zsh configuration
├── .vimrc                # Vim configuration
└── README.md

🛡️ Privacy & Security

• ✅ No API keys, tokens, or credentials
• ✅ No hardcoded passwords or secrets
• ✅ No private SSH keys
• ✅ Personal paths replaced with template variables
• ✅ Shell history excluded from git
• ✅ Email addresses templated

💡 Tips

1. First Time Setup: Run p10k configure after installation to customize your prompt
2. Git Workflow: Aliases assume main as the default branch (not master)
3. Docker: Includes cleanup aliases for old containers

🤝 Contributing

Feel free to:

• Submit improvements to aliases or configurations
• Add new useful development shortcuts
• Improve the template/restore process
• Fix macOS compatibility issues

📄 License

MIT License - feel free to adapt this template for your own use!

---

This template was created to share useful dotfiles configurations while maintaining privacy and security.