{"id":31424932,"url":"https://github.com/bhavikbhavsar/macos-dev-setup","last_synced_at":"2026-04-10T11:32:17.716Z","repository":{"id":317199502,"uuid":"1066349689","full_name":"bhavikbhavsar/macos-dev-setup","owner":"bhavikbhavsar","description":"⚡ Automated macOS setup for developers - 50+ tools, Python env, Zsh config","archived":false,"fork":false,"pushed_at":"2025-09-29T12:49:36.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-29T14:41:33.746Z","etag":null,"topics":["automation","command-line","developer-tools","dotfiles","homebrew","macos","productivity","python","setup-script","shell","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bhavikbhavsar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-29T11:12:29.000Z","updated_at":"2025-09-29T12:49:40.000Z","dependencies_parsed_at":"2025-09-29T14:42:10.139Z","dependency_job_id":null,"html_url":"https://github.com/bhavikbhavsar/macos-dev-setup","commit_stats":null,"previous_names":["bhavikbhavsar/macos-dev-setup"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bhavikbhavsar/macos-dev-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavikbhavsar%2Fmacos-dev-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavikbhavsar%2Fmacos-dev-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavikbhavsar%2Fmacos-dev-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavikbhavsar%2Fmacos-dev-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bhavikbhavsar","download_url":"https://codeload.github.com/bhavikbhavsar/macos-dev-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavikbhavsar%2Fmacos-dev-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31641114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","command-line","developer-tools","dotfiles","homebrew","macos","productivity","python","setup-script","shell","zsh"],"created_at":"2025-09-30T04:40:16.793Z","updated_at":"2026-04-10T11:32:17.709Z","avatar_url":"https://github.com/bhavikbhavsar.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🍎 macOS Developer Setup Automation\n\n\u003c!-- Badges --\u003e\n[![GitHub stars](https://img.shields.io/github/stars/bhavikbhavsar/macos-dev-setup.svg?style=social\u0026label=Star)](https://github.com/bhavikbhavsar/macos-dev-setup)\n[![GitHub forks](https://img.shields.io/github/forks/bhavikbhavsar/macos-dev-setup.svg?style=social\u0026label=Fork)](https://github.com/bhavikbhavsar/macos-dev-setup/fork)\n[![GitHub issues](https://img.shields.io/github/issues/bhavikbhavsar/macos-dev-setup.svg)](https://github.com/bhavikbhavsar/macos-dev-setup/issues)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003e **From 6 hours to 12 minutes**: Automate your entire macOS developer environment setup with a single command.\n\n**⭐ If this saves you time, please consider starring the repo! It helps others discover it too.**\n\n---\n\n## 🚀 Why This Exists\n\nSetting up a new Mac for development is painful:\n- ❌ Hours of manual downloads and installations\n- ❌ Forgetting essential tools and configurations  \n- ❌ Inconsistent setups across team members\n- ❌ No easy way to reproduce your perfect environment\n\n**This script changes everything.** One command, 12 minutes, perfect developer setup.\n\n## ✨ What You Get\n\n### 🛠️ **50+ Essential Developer Tools**\nAutomatically installs via Homebrew:\n\n| Category | Tools |\n|----------|-------|\n| **CLI Essentials** | `git`, `gh`, `tmux`, `fzf`, `ripgrep`, `fd`, `bat`, `jq`, `httpie`, `tree`, `eza` |\n| **Development** | `node`, `python`, `pyenv`, `pipx`, `poetry`, `uv`, `go`, `rust`, `docker` |\n| **Applications** | VS Code, iTerm2, Sublime Text, CleanShot, Notion, Raycast, Bitwarden, Chrome, Slack, Discord, Figma, Zoom, OBS |\n| **Fonts** | Hack Nerd Font, Meslo LG Nerd Font |\n\n### 🐍 **Python Development Environment**\n- Python 3.12.5 via pyenv\n- Poetry for dependency management\n- Pre-commit hooks for code quality\n- Virtual environment best practices\n\n### 🌟 **Enhanced Terminal Experience**\n- **Starship prompt** with Git integration\n- **Auto-suggestions** and syntax highlighting  \n- **50+ productivity aliases** and functions\n- Oh My Zsh with curated plugins\n\n### ⚙️ **macOS Optimizations**\n- **Finder**: Show hidden files, path bar, status bar\n- **Trackpad**: Tap to click, three-finger drag\n- **Keyboard**: Fast repeat rates, full keyboard access\n- **Screenshots**: JPG format, organized location\n- **Dock**: Auto-hide, faster animations\n- **Developer-friendly**: Disable auto-correct, smart quotes\n\n## 📺 Demo\n\n\u003c!-- Add your demo GIF/video here --\u003e\n```bash\n# Before: 6+ hours of manual setup 😤\n# After: Single command automation ⚡\n\n./setup.sh\n# ↳ 12 minutes later: Perfect developer environment ✨\n```\n\n*[Demo GIF/Video coming soon - star the repo to be notified!]*\n\n## 🚀 Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/bhavikbhavsar/macos-dev-setup.git\ncd macos-dev-setup\n\n# 🎯 IMPORTANT: Customize Git settings (30 seconds)\n# Edit these lines in setup.sh:\n# DEFAULT_GIT_NAME=\"Your Name\"\n# DEFAULT_GIT_EMAIL=\"your.email@example.com\"\n\n# Make executable and run\nchmod +x setup.sh\n./setup.sh\n\n# Grab a coffee ☕ - you're done in ~12 minutes!\n```\n\n## 🔄 Need to Revert?\n\nNo problem! Complete restoration script included:\n\n```bash\nchmod +x restore.sh\n./restore.sh\n# Safely removes everything and restores your original setup\n```\n\n## 📁 What's Inside\n\n```\nmac-setup/\n├── 📦 Brewfile           # 50+ packages and applications  \n├── ⚙️  macos-defaults.sh  # System preferences optimization\n├── 🚀 setup.sh           # Main automation script (idempotent)\n├── 🔄 restore.sh         # Complete restoration script\n├── 🐚 .zshrc             # Enhanced shell configuration\n└── 📖 README.md          # You are here!\n```\n\n## ⚡ Key Features\n\n- **🔄 Idempotent**: Run multiple times safely - won't break existing setups\n- **🛡️ Non-destructive**: Backs up existing configs automatically\n- **🎯 Customizable**: Easy to modify for your specific needs\n- **⚡ Fast**: Complete setup in ~12 minutes vs 6+ hours manually\n- **🧹 Reversible**: Full restore script to undo everything\n- **🤝 Team-friendly**: Consistent environments across your team\n\n## 🎨 Customization\n\n### 🔧 Add Your Own Tools\n\nEdit `Brewfile` to include your favorite tools:\n```ruby\n# Add CLI tools\nbrew \"your-favorite-tool\"\n\n# Add applications  \ncask \"your-favorite-app\"\n```\n\n### 🎯 Modify System Preferences\n\nEdit `macos-defaults.sh` to customize system behavior:\n```bash\n# Example: Change dock size\ndefaults write com.apple.dock tilesize -int 48\n```\n\n### 🐚 Enhance Shell Experience\n\nCustomize `.zshrc` with your aliases and functions:\n```bash\n# Your custom aliases\nalias myproject=\"cd ~/Developer/my-awesome-project\"\n```\n\n\n## 📊 Stats\n\n- ⭐ **Stars**: Growing daily!  \n- 🍴 **Forks**: Customized by developers worldwide\n- 💬 **Community**: Active discussions in Issues\n- ⏱️ **Time Saved**: 5.75+ hours per developer\n\n## 🤝 Contributing\n\nWe love contributions! This project thrives on community input.\n\n### 🎯 How to Help\n\n- **⭐ Star the repo** - Helps others discover it\n- **🍴 Fork and customize** - Share your modifications  \n- **🐛 Report issues** - Found a bug? Let us know!\n- **💡 Suggest improvements** - New tools, better configs\n- **📝 Improve docs** - Better explanations, more examples\n\n### 🏁 Good First Issues\n\n- [ ] Add more package suggestions  \n- [ ] Create setup variations (minimal, full, language-specific)\n- [ ] Improve error handling and logging\n- [ ] Add pre-commit hooks to the repository\n- [ ] Create setup for other platforms (Linux, Windows)\n\n## 💬 Community\n\n- **💭 Discussions**: Share your customizations in [Issues](https://github.com/bhavikbhavsar/macos-dev-setup/issues)\n- **🐛 Bug Reports**: Found something broken? Please report it!  \n- **💡 Feature Requests**: Got ideas? We'd love to hear them!\n- **🎉 Show \u0026 Tell**: Share your customized setup\n\n## 📚 Inspiration \u0026 Similar Projects\n\n*Standing on the shoulders of giants:*\n\n- [mathiasbynens/dotfiles](https://github.com/mathiasbynens/dotfiles) - macOS defaults inspiration\n- [Homebrew Bundle](https://github.com/Homebrew/homebrew-bundle) - Package management approach  \n- [Oh My Zsh](https://github.com/ohmyzsh/ohmyzsh) - Shell enhancement framework\n\n## 🚨 System Requirements\n\n- **macOS**: Tested on recent versions (10.15+)\n- **Internet**: Required for package downloads\n- **Admin Access**: Needed for system modifications\n- **Time**: ~12 minutes for complete setup\n\n## 📝 Post-Setup Checklist\n\n- [ ] Restart terminal: `source ~/.zshrc`  \n- [ ] Add SSH key to GitHub (if generated)\n- [ ] Verify Python: `python --version` and `poetry --version`\n- [ ] Test new aliases: `ll`, `gs`, `gc`\n- [ ] Restart Mac for all system preferences\n- [ ] **⭐ Star this repo if it helped you!**\n\n## 🎯 What's Next?\n\n**Roadmap** (vote on priorities in Issues!):\n- [ ] **GUI setup tool** for non-technical users\n- [ ] **Linux/Windows** support\n\n## 📄 License\n\nMIT License - Use it, fork it, love it! See [LICENSE](LICENSE) file for details.\n\n---\n\n## 💝 Show Your Support\n\n**If this project saved you time:**\n\n- ⭐ **Star the repository** (it really helps!)\n- 🍴 **Fork it** and customize for your team  \n- 📢 **Share it** with fellow developers\n- ☕ **Buy me a coffee** (optional link)\n- 💬 **Leave feedback** in the Issues\n\n**Built with ❤️ by developers, for developers.**\n\n*Last updated: 29 September 2025 - Always improving! 🚀*\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n**⭐ Don't forget to star the repo if this helped you! ⭐**\n\nMade something cool with this setup? [Share it with us!](https://github.com/bhavikbhavsar/macos-dev-setup/issues/new?template=show-and-tell.md)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhavikbhavsar%2Fmacos-dev-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhavikbhavsar%2Fmacos-dev-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhavikbhavsar%2Fmacos-dev-setup/lists"}