All notable changes to this dotfiles project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Editor: VS Code → Zed. Replaced the
vscoderole with azedrole (~/.config/zed/settings.json, caskzed, dock + key-repeat, backup paths).VISUALnow points atzed --wait;EDITOR/git editor remainvim.
- Bootstrap no longer aborts on a fresh clone:
git_emailhas a safe default andmasinstall tolerates a not-signed-in App Store; mise pins python 3.13 + ruby 3.
- Automated Dock Setup: Clear existing dock items and configure with specified applications
- Template-based Configuration: Easily customizable dock applications via Ansible variables
- macOS Version Compatibility: Automatic handling of System Settings vs System Preferences
- Smart Application Detection: Graceful handling of missing applications with warnings
- Optimized Dock Settings: Left positioning, 48px size, disabled autohide and recent apps
- Flexible Application Paths: Support for fallback paths and custom application locations
- Google Chrome, Alacritty, Terminal, VS Code, Messages, Find My, Notes, System Settings, iPhone Mirroring, TextEdit
- Dock applications defined in
roles/macos/defaults/main.ymlunderdock_apps - Dock behavior settings in
roles/macos/templates/configure-dock.sh.j2
- Comprehensive Backup Role: Complete backup strategy for safe development environment management
- Bootstrap Safety Checkpoints: Automatic safety points during environment setup process
- Multi-Layer Protection: Time Machine + selective configs + bootstrap checkpoints
- Emergency Recovery Tools: Quick rollback and restoration capabilities
- Encrypted Security Backup: GPG encryption for SSH keys, credentials, and sensitive data
- Non-networked Drive Support: Local + external backup sync without requiring network drives
- Mackup Integration: Application settings preservation across macOS reinstalls
- Integrity Verification: Backup health checks and validation system
- backup-create: Full & selective backups with encryption support
- backup-restore: Granular restoration with interactive mode
- backup-checkpoint: Bootstrap process safety checkpoints
- backup-list: Advanced backup management & listing
- backup-rollback: Emergency recovery & rollback system
- backup-monitor: Health checks and automated maintenance
- backup-verify: Backup integrity validation
- Bootstrap Failure: Roll back to any checkpoint during setup
- Configuration Issues: Restore specific application settings
- Complete System Loss: Full environment reconstruction from backups
- Selective Recovery: Granular restoration of individual components
- HomeAssistant Ecosystem: Full setup with PostgreSQL, MQTT, Zigbee2MQTT
- AI-Powered Security: Frigate NVR with real-time object detection
- Professional Monitoring: Grafana + Prometheus + AlertManager stack
- Secure Remote Access: Tailscale mesh VPN with exit node capabilities
- Network Protection: AdGuard Home for network-wide ad blocking
- Layered Deployment: Bootstrap → Networking → Automation → Monitoring
- Docker-First Design: All services containerized for reliability
- One-Command Setup: Complete home server in single command
- Professional Grade: Enterprise-level monitoring and security
- Multi-Protocol Support: Zigbee, Matter, WiFi, LoRaWAN devices
- Voice Assistant Integration: Google Home, Apple HomeKit, AirPlay
- Popular Platforms: Philips Hue, Chromecast, smart switches/sensors
- CCTV Integration: AI-powered camera monitoring with Frigate
- HACS Ecosystem: Popular community integrations and dashboards
- Identity Transformation: Complete removal of sloria references
- Remote Environment: Completely overhauled
remote_env.ymlarchitecture - Service Labels: Updated plist files with new naming convention
- Docker Architecture: Services now run in containers vs. native installs
- New Roles: homeassistant, frigate, monitoring, tailscale (enhanced)
- Deployment Flexibility: Tag-based deployment for specific layers/services
- Comprehensive Templates: Full configuration templates for all services
- Health Monitoring: Service health checks and automatic recovery
- Security Hardening: Firewall rules, encrypted storage, VPN access
- Professional Documentation: Complete guides for setup and maintenance
- AdGuard Role: Docker-based deployment with comprehensive configuration
- macOS Optimization: Server-first configuration for 24/7 operation
- Network Configuration: Advanced networking with VPN and DNS management
- Monitoring Integration: Real-time dashboards for all services
- Tailscale Integration: Secure mesh VPN with Magic DNS
- Exit Node Capabilities: Route internet traffic through home server
- Network Segmentation: Isolated access with fine-grained control
- DNS Filtering: Comprehensive ad and malware blocking
- SSL/TLS: HTTPS for all web interfaces with automated certificates
- Real-time Dashboards: Beautiful Grafana visualizations
- Intelligent Alerting: Smart notifications with escalation policies
- Performance Metrics: System, container, and application monitoring
- Historical Data: 30-day metrics retention with automatic cleanup
- Health Checks: Comprehensive service status monitoring
- Complete documentation overhaul with professional-but-cheeky tone
- Comprehensive README files throughout repository structure
- Interactive file tree with hyperlinks in main README
- ASCII art header and visual enhancements
- One-command installation: Fresh macOS setup with
curl | bashinstaller - Interactive configuration:
dot-configurescript for secrets and preferences - Project scaffolding:
newprojectcommand with CI/CD templates - Modern CLI replacements: eza, bat, ripgrep, fzf, fd integration
- VS Code optimization: Language-specific settings and extensions
- GitHub Actions templates: Python, Node.js, and Rust workflows
- Pre-commit automation: Code quality hooks and formatting
- Alacritty configuration: Custom themes and terminal setup
- Security enhancements: GPG signing, SSH key management
- Monitoring integration: Beszel agent for system metrics
- Complete identity transformation: Steven Loria → woodrow pearson
- Streamlined application list: Aligned with personal questionnaire responses
- Enhanced shell experience: ZSH with Prezto and Pure theme
- Improved error handling: Better script safety and user feedback
- Updated tool versions: Latest mise configuration and package versions
- Repository structure: Organized roles and improved modularity
- Git configuration issues: Email privacy and signing setup
- Homebrew permissions: Resolved installation conflicts
- Ansible role dependencies: Fixed broken references
- Script security: Removed unsafe eval usage
- Documentation gaps: Comprehensive guides for all features
- Unused packages: Cleaned up unnecessary Homebrew packages
- Legacy configurations: Removed outdated tool setups
- Redundant aliases: Streamlined command shortcuts
- Enhanced Git configuration with delta diff viewer
- Kubernetes tools (kubectl, k9s) with smart aliases
- Docker integration with useful commands and aliases
- Python environment management improvements
- Updated Python packages and virtual environment handling
- Improved terminal color schemes and themes
- Enhanced vim configuration with modern plugins
- Homebrew installation reliability on newer macOS versions
- SSH key generation and GitHub integration
- mise (formerly rtx) for runtime version management
- Enhanced ZSH configuration with better completion
- Improved Git aliases and workflow commands
- macOS system preferences automation
- Migrated from pyenv to mise for Python version management
- Updated Homebrew package list for modern development
- Improved Ansible role organization and tagging
- ZSH shell switching on macOS Ventura
- Git signing configuration edge cases
- Core automation: Ansible-based configuration management
- Shell setup: ZSH with Prezto framework
- Development tools: Python, Node.js, basic CLI tools
- Git configuration: Basic setup with aliases
- macOS preferences: System defaults and dock configuration
- Vim setup: Basic configuration with essential plugins
- Solid foundation from Steven Loria's excellent dotfiles
- Proven Ansible automation patterns
- Cross-platform compatibility considerations
- Modular role-based architecture
- Breaking changes to core functionality
- Complete workflow changes
- Major architectural overhauls
- New features and tools
- Enhanced existing functionality
- New automation capabilities
- Bug fixes and small improvements
- Documentation updates
- Security patches
- Enhanced terminal multiplexer integration (tmux/zellij)
- Advanced Git workflow automation
- Cloud development environment support
- Additional language runtime support (Go, Ruby)
- Enhanced monitoring and metrics collection
- Linux compatibility layer
- Windows Subsystem for Linux support
- Automated backup and sync capabilities
- AI-powered development tool integration
- Advanced security hardening options
- Backup your customizations before upgrading
- Review personal settings in
group_vars/local - Update any custom roles to use new tagging system
- Regenerate SSH/GPG keys if needed for new identity
- Run full bootstrap to ensure clean state
- Personal identity completely changed (requires manual update)
- Some package names changed due to tool updates
- Git configuration requires regeneration for signing
- VS Code settings structure updated
This project builds upon the excellent work of Steven Loria. While completely transformed for personal use, the solid architectural foundation and Ansible automation patterns deserve recognition.
- Bug reports and feature suggestions from users
- Testing and validation across different macOS versions
- Documentation improvements and clarifications
- Various dotfiles repositories across GitHub
- Modern CLI tool ecosystem
- macOS automation community best practices
For detailed technical changes, see individual commit messages and pull request descriptions.