██████╗ ██████╗ ████████╗███████╗██╗██╗ ███████╗███████╗
██╔══██╗██╔═══██╗╚══██╔══╝██╔════╝██║██║ ██╔════╝██╔════╝
██║ ██║██║ ██║ ██║ █████╗ ██║██║ █████╗ ███████╗
██║ ██║██║ ██║ ██║ ██╔══╝ ██║██║ ██╔══╝ ╚════██║
██████╔╝╚██████╔╝ ██║ ██║ ██║███████╗███████╗███████║
╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚══════╝╚══════╝╚══════╝
From fresh macOS to productive dev environment + ultimate home server in < 30 minutes ⚡
One command. Seriously.
curl -fsSL https://github.com/woodrowpearson/dotfiles/raw/main/bin/dot-install | bashThen grab a coffee ☕ while your Mac transforms into a developer powerhouse.
| 🎯 Feature | 🔥 Why You'll Love It |
|---|---|
| Zero-to-Hero Setup | Fresh macOS → Fully configured dev environment in one command |
| 🏠 Ultimate Home Server | Complete HomeAssistant + Frigate + monitoring stack |
| 🛡️ Multi-Layer Backup System | Encrypted checkpoints + graceful failure handling + Time Machine integration |
| Smart Project Scaffolding | newproject python my-api → Complete project with CI/CD ready |
| 🌐 Mesh VPN Access | Tailscale integration for secure remote access |
| 📊 Comprehensive Monitoring | Grafana + Prometheus + real-time analytics |
| 🔒 Network-wide Ad Blocking | AdGuard Home protecting all your devices |
| Interactive Configuration | Guided setup for API keys, SSH, GPG (no more googling! eh maybe some.. ) |
| Modern Everything | Alacritty + ZSH + 15+ CLI tool upgrades with smart aliases |
Click around and explore! Each 📁 links to detailed documentation.
dotfiles/
├── 📁 [bin/](bin/README.md) # Automation scripts that do the magic
│ ├── dot-install # One-command fresh macOS setup
│ ├── dot-bootstrap # Complete environment installation
│ ├── dot-configure # Interactive post-setup wizard
│ ├── newproject # Smart project scaffolding
│ └── upgrades # Keep everything fresh
├── 📁 [roles/](roles/README.md) # Ansible roles (the real workhorses)
│ ├── 🏠 homeassistant/ # Complete smart home ecosystem
│ ├── 📹 frigate/ # AI-powered camera monitoring
│ ├── 📊 monitoring/ # Grafana + Prometheus stack
│ ├── 🌐 tailscale/ # Mesh VPN networking
│ ├── 🛡️ adguard/ # Network-wide ad blocking
│ ├── 💾 backup/ # Encrypted checkpoints + graceful recovery system
│ ├── 🏠 alacritty/ # Terminal that doesn't suck
│ ├── 🐍 python/ # Python done right (uv + tools)
│ ├── 🦀 rust/ # Systems programming goodness
│ ├── 🚀 vscode/ # Editor config + extensions
│ ├── 🐚 zsh/ # Shell that makes you productive
│ └── 🎨 macos/ # System settings automation
├── 📁 [templates/](templates/README.md) # CI/CD templates for new projects
│ ├── .github/workflows/ # GitHub Actions that work
│ └── .pre-commit-config.yaml # Code quality automation
├── 📁 [docs/](docs/) # Deep-dive documentation
│ ├── 📖 [INSTALLATION.md](docs/INSTALLATION.md) # Detailed setup guide
│ ├── ⭐ [FEATURES.md](docs/FEATURES.md) # Comprehensive feature list
│ ├── 🎨 [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) # Make it truly yours
│ ├── 💻 [TERMINAL_CONFIGURATION.md](docs/TERMINAL_CONFIGURATION.md) # Enhanced terminal setup
│ └── 🔧 [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) # When things go sideways
├── ⚙️ [group_vars/local](group_vars/) # Configuration that matters
├── 🎬 [CLAUDE.md](CLAUDE.md) # Claude Code integration guide
└── 📜 [CHANGELOG.md](CHANGELOG.md) # What's new and noteworthy
Transform your Mac Mini into a comprehensive smart home hub with one command:
# Deploy the entire home automation stack
ansible-playbook -i hosts remote_env.yml| 📱 Service | 🔗 Access | 🎯 Purpose |
|---|---|---|
| HomeAssistant | :8123 |
Complete smart home automation |
| Frigate NVR | :5000 |
AI-powered camera monitoring |
| Grafana | :3000 |
Beautiful monitoring dashboards |
| AdGuard Home | :3001 |
Network-wide ad blocking |
| Tailscale VPN | mesh | Secure remote access |
- ✨ Zigbee + Matter + WiFi device support
- 📹 AI CCTV with object detection (Frigate)
- 🏠 Google Home + AirPlay integration
- 💡 Hue lights + smart switches
- 📶 LoRaWAN for long-range IoT
- 🌍 Remote access via Tailscale mesh VPN
- Real-time system metrics and alerts
- Container health and resource usage
- Network traffic analysis
- Smart home device status tracking
- Performance dashboards and trends
# One command from fresh Mac to development env
curl -fsSL https://github.com/woodrowpearson/dotfiles/raw/main/bin/dot-install | bash
cd ~/dotfiles && ./bin/dot-bootstrap && ./bin/dot-configure# Complete-ish smart home automation stack
ansible-playbook -i hosts remote_env.yml
# OR deploy specific layers:
ansible-playbook -i hosts remote_env.yml --tags homeautomation
ansible-playbook -i hosts remote_env.yml --tags monitoring# Smart scaffolding with CI/CD, pre-commit hooks, and best practices
newproject python my-awesome-api
cd ~/code/my-awesome-api
code . # Opens with all the right extensions# Edit dock applications in roles/macos/defaults/main.yml
# Then apply changes:
ansible-playbook -i hosts local_env.yml --tags macos# Your new superpowers (all included)
ls # → eza (with icons!)
cat file # → bat (syntax highlighting)
grep "x" # → rg (ripgrep - stupid fast)
find # → fd (sensible defaults)Built on battle-tested foundations:
- Ansible: Declarative, idempotent, reliable automation
- Homebrew: Package management that doesn't fight you
- Modern CLI Tools: Because life's too short for ancient Unix tools
- Opinionated Defaults: Sensible choices you can override
Philosophy: Automate Everything Possible, Guide Through What Can't Be
Huge props to Steven Loria for the original dotfiles that inspired this. What started as a simple fork has evolved into something much more comprehensive, but the core philosophy remains: make developer setup painless - make life less painful for family dealing with my projects.
Found a bug? Of course you did! Have an idea? Fork! Want to add your favorite tool? aloso, fork!
👥 Contributing Guide → Prefer bug fixes over feature fixes.
- 🐛 Issues: GitHub Issues
- ⭐ Star this repo if it saved you time!
Your terminal will thank you. Your productivity will soar. Your partner & family will be happy-er. 😎