https://github.com/bhavikbhavsar/macos-dev-setup
⚡ Automated macOS setup for developers - 50+ tools, Python env, Zsh config
https://github.com/bhavikbhavsar/macos-dev-setup
automation command-line developer-tools dotfiles homebrew macos productivity python setup-script shell zsh
Last synced: about 1 month ago
JSON representation
⚡ Automated macOS setup for developers - 50+ tools, Python env, Zsh config
- Host: GitHub
- URL: https://github.com/bhavikbhavsar/macos-dev-setup
- Owner: bhavikbhavsar
- License: mit
- Created: 2025-09-29T11:12:29.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-29T12:49:36.000Z (8 months ago)
- Last Synced: 2025-09-29T14:41:33.746Z (8 months ago)
- Topics: automation, command-line, developer-tools, dotfiles, homebrew, macos, productivity, python, setup-script, shell, zsh
- Language: Shell
- Homepage:
- Size: 26.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🍎 macOS Developer Setup Automation
[](https://github.com/bhavikbhavsar/macos-dev-setup)
[](https://github.com/bhavikbhavsar/macos-dev-setup/fork)
[](https://github.com/bhavikbhavsar/macos-dev-setup/issues)
[](https://opensource.org/licenses/MIT)
> **From 6 hours to 12 minutes**: Automate your entire macOS developer environment setup with a single command.
**⭐ If this saves you time, please consider starring the repo! It helps others discover it too.**
---
## 🚀 Why This Exists
Setting up a new Mac for development is painful:
- ❌ Hours of manual downloads and installations
- ❌ Forgetting essential tools and configurations
- ❌ Inconsistent setups across team members
- ❌ No easy way to reproduce your perfect environment
**This script changes everything.** One command, 12 minutes, perfect developer setup.
## ✨ What You Get
### 🛠️ **50+ Essential Developer Tools**
Automatically installs via Homebrew:
| Category | Tools |
|----------|-------|
| **CLI Essentials** | `git`, `gh`, `tmux`, `fzf`, `ripgrep`, `fd`, `bat`, `jq`, `httpie`, `tree`, `eza` |
| **Development** | `node`, `python`, `pyenv`, `pipx`, `poetry`, `uv`, `go`, `rust`, `docker` |
| **Applications** | VS Code, iTerm2, Sublime Text, CleanShot, Notion, Raycast, Bitwarden, Chrome, Slack, Discord, Figma, Zoom, OBS |
| **Fonts** | Hack Nerd Font, Meslo LG Nerd Font |
### 🐍 **Python Development Environment**
- Python 3.12.5 via pyenv
- Poetry for dependency management
- Pre-commit hooks for code quality
- Virtual environment best practices
### 🌟 **Enhanced Terminal Experience**
- **Starship prompt** with Git integration
- **Auto-suggestions** and syntax highlighting
- **50+ productivity aliases** and functions
- Oh My Zsh with curated plugins
### ⚙️ **macOS Optimizations**
- **Finder**: Show hidden files, path bar, status bar
- **Trackpad**: Tap to click, three-finger drag
- **Keyboard**: Fast repeat rates, full keyboard access
- **Screenshots**: JPG format, organized location
- **Dock**: Auto-hide, faster animations
- **Developer-friendly**: Disable auto-correct, smart quotes
## 📺 Demo
```bash
# Before: 6+ hours of manual setup 😤
# After: Single command automation ⚡
./setup.sh
# ↳ 12 minutes later: Perfect developer environment ✨
```
*[Demo GIF/Video coming soon - star the repo to be notified!]*
## 🚀 Quick Start
```bash
# Clone the repository
git clone https://github.com/bhavikbhavsar/macos-dev-setup.git
cd macos-dev-setup
# 🎯 IMPORTANT: Customize Git settings (30 seconds)
# Edit these lines in setup.sh:
# DEFAULT_GIT_NAME="Your Name"
# DEFAULT_GIT_EMAIL="your.email@example.com"
# Make executable and run
chmod +x setup.sh
./setup.sh
# Grab a coffee ☕ - you're done in ~12 minutes!
```
## 🔄 Need to Revert?
No problem! Complete restoration script included:
```bash
chmod +x restore.sh
./restore.sh
# Safely removes everything and restores your original setup
```
## 📁 What's Inside
```
mac-setup/
├── 📦 Brewfile # 50+ packages and applications
├── ⚙️ macos-defaults.sh # System preferences optimization
├── 🚀 setup.sh # Main automation script (idempotent)
├── 🔄 restore.sh # Complete restoration script
├── 🐚 .zshrc # Enhanced shell configuration
└── 📖 README.md # You are here!
```
## ⚡ Key Features
- **🔄 Idempotent**: Run multiple times safely - won't break existing setups
- **🛡️ Non-destructive**: Backs up existing configs automatically
- **🎯 Customizable**: Easy to modify for your specific needs
- **⚡ Fast**: Complete setup in ~12 minutes vs 6+ hours manually
- **🧹 Reversible**: Full restore script to undo everything
- **🤝 Team-friendly**: Consistent environments across your team
## 🎨 Customization
### 🔧 Add Your Own Tools
Edit `Brewfile` to include your favorite tools:
```ruby
# Add CLI tools
brew "your-favorite-tool"
# Add applications
cask "your-favorite-app"
```
### 🎯 Modify System Preferences
Edit `macos-defaults.sh` to customize system behavior:
```bash
# Example: Change dock size
defaults write com.apple.dock tilesize -int 48
```
### 🐚 Enhance Shell Experience
Customize `.zshrc` with your aliases and functions:
```bash
# Your custom aliases
alias myproject="cd ~/Developer/my-awesome-project"
```
## 📊 Stats
- ⭐ **Stars**: Growing daily!
- 🍴 **Forks**: Customized by developers worldwide
- 💬 **Community**: Active discussions in Issues
- ⏱️ **Time Saved**: 5.75+ hours per developer
## 🤝 Contributing
We love contributions! This project thrives on community input.
### 🎯 How to Help
- **⭐ Star the repo** - Helps others discover it
- **🍴 Fork and customize** - Share your modifications
- **🐛 Report issues** - Found a bug? Let us know!
- **💡 Suggest improvements** - New tools, better configs
- **📝 Improve docs** - Better explanations, more examples
### 🏁 Good First Issues
- [ ] Add more package suggestions
- [ ] Create setup variations (minimal, full, language-specific)
- [ ] Improve error handling and logging
- [ ] Add pre-commit hooks to the repository
- [ ] Create setup for other platforms (Linux, Windows)
## 💬 Community
- **💭 Discussions**: Share your customizations in [Issues](https://github.com/bhavikbhavsar/macos-dev-setup/issues)
- **🐛 Bug Reports**: Found something broken? Please report it!
- **💡 Feature Requests**: Got ideas? We'd love to hear them!
- **🎉 Show & Tell**: Share your customized setup
## 📚 Inspiration & Similar Projects
*Standing on the shoulders of giants:*
- [mathiasbynens/dotfiles](https://github.com/mathiasbynens/dotfiles) - macOS defaults inspiration
- [Homebrew Bundle](https://github.com/Homebrew/homebrew-bundle) - Package management approach
- [Oh My Zsh](https://github.com/ohmyzsh/ohmyzsh) - Shell enhancement framework
## 🚨 System Requirements
- **macOS**: Tested on recent versions (10.15+)
- **Internet**: Required for package downloads
- **Admin Access**: Needed for system modifications
- **Time**: ~12 minutes for complete setup
## 📝 Post-Setup Checklist
- [ ] Restart terminal: `source ~/.zshrc`
- [ ] Add SSH key to GitHub (if generated)
- [ ] Verify Python: `python --version` and `poetry --version`
- [ ] Test new aliases: `ll`, `gs`, `gc`
- [ ] Restart Mac for all system preferences
- [ ] **⭐ Star this repo if it helped you!**
## 🎯 What's Next?
**Roadmap** (vote on priorities in Issues!):
- [ ] **GUI setup tool** for non-technical users
- [ ] **Linux/Windows** support
## 📄 License
MIT License - Use it, fork it, love it! See [LICENSE](LICENSE) file for details.
---
## 💝 Show Your Support
**If this project saved you time:**
- ⭐ **Star the repository** (it really helps!)
- 🍴 **Fork it** and customize for your team
- 📢 **Share it** with fellow developers
- ☕ **Buy me a coffee** (optional link)
- 💬 **Leave feedback** in the Issues
**Built with ❤️ by developers, for developers.**
*Last updated: 29 September 2025 - Always improving! 🚀*
---
**⭐ Don't forget to star the repo if this helped you! ⭐**
Made something cool with this setup? [Share it with us!](https://github.com/bhavikbhavsar/macos-dev-setup/issues/new?template=show-and-tell.md)