https://github.com/devadathanmb/mac-dotfiles
Hello, welcome $HOME
https://github.com/devadathanmb/mac-dotfiles
Last synced: about 1 month ago
JSON representation
Hello, welcome $HOME
- Host: GitHub
- URL: https://github.com/devadathanmb/mac-dotfiles
- Owner: devadathanmb
- License: gpl-3.0
- Created: 2025-08-29T20:26:43.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-22T13:42:45.000Z (about 1 month ago)
- Last Synced: 2026-02-22T17:04:35.602Z (about 1 month ago)
- Language: Shell
- Size: 418 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dotfiles
> Hello, welcome $HOME
Personal dotfiles repository for macOS, managed with [Ansible](https://docs.ansible.com/) orchestrating [Dotbot](https://github.com/deadc0de6/dotbot) for symlinks.
## Quick Start
### Full setup
```bash
git clone https://github.com/devadathanmb/mac-dotfiles.git ~/.mac-dots
cd ~/.mac-dots
./ansible/bootstrap.sh
```
### Selective execution
```bash
cd ~/.mac-dots/ansible
# Run all roles
ansible-playbook playbooks/main.yml
# Run specific roles
ansible-playbook playbooks/main.yml --tags dotbot # Symlinks
ansible-playbook playbooks/main.yml --tags homebrew # Homebrew packages
ansible-playbook playbooks/main.yml --tags macos # macOS defaults
ansible-playbook playbooks/main.yml --tags zsh # ZSH (Zap ZSH)
ansible-playbook playbooks/main.yml --tags editors # Editor extensions
ansible-playbook playbooks/asdf.yml # ASDF (Python + Node.js)
# Dry-run (preview changes)
ansible-playbook playbooks/main.yml --check --diff
```
### Backup
```bash
cd ~/.mac-dots/ansible
ansible-playbook playbooks/backup.yml
```
## Structure
```
ansible/
├── ansible.cfg # Ansible configuration
├── requirements.yml # Ansible collections
├── bootstrap.sh # Fresh install entry point
├── inventory/
│ └── localhost.yml # Localhost inventory
├── group_vars/
│ └── all.yml # Shared variables
├── playbooks/
│ ├── main.yml # Orchestrates all roles
│ ├── dotbot.yml # Dotbot symlinks
│ ├── packages.yml # Homebrew packages
│ ├── macos.yml # macOS defaults
│ ├── zsh.yml # Zap ZSH shell
│ ├── editors.yml # VSCode + Cursor extensions
│ ├── asdf.yml # ASDF version manager
│ └── backup.yml # Backup packages/extensions
└── roles/
├── dotbot/ # Orchestrates ./install
├── homebrew/ # Homebrew packages
├── macos/ # System defaults
├── zsh/ # Zap ZSH
├── editors/ # Editor extensions
└── asdf/ # ASDF
```
## License
[GPL 3.0](./LICENSE)