https://github.com/mattdowney/dotfiles
A fully automated dotfiles setup for macOS. Installs essential tools (Homebrew, Node.js, PHP, Composer, Git, Zsh, and more) in minutes with a single command.
https://github.com/mattdowney/dotfiles
composer dev-environment dotfiles homebrew macos nodejs php setup-script volta zsh
Last synced: about 2 months ago
JSON representation
A fully automated dotfiles setup for macOS. Installs essential tools (Homebrew, Node.js, PHP, Composer, Git, Zsh, and more) in minutes with a single command.
- Host: GitHub
- URL: https://github.com/mattdowney/dotfiles
- Owner: mattdowney
- Created: 2025-03-18T21:37:28.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-18T23:20:07.000Z (11 months ago)
- Last Synced: 2025-03-19T00:26:03.964Z (11 months ago)
- Topics: composer, dev-environment, dotfiles, homebrew, macos, nodejs, php, setup-script, volta, zsh
- Language: Shell
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 Dotfiles & Dev Environment Setup
This repository contains my **dotfiles** and a fully automated **install script** to set up a macOS development environment in minutes.
## 📌 **Installation Instructions**
### **1⃣ Clone the Dotfiles Repo**
```sh
git clone git@github.com:mattdowney/dotfiles.git ~/dotfiles
```
### **2⃣ Run the Install Script**
```sh
bash ~/dotfiles/install.sh
```
### **3⃣ Restart Your Terminal**
```sh
exec zsh
```
Or manually close and reopen your terminal.
---
## ⚡ **What This Installs**
### **System Tools**
- 🍺 **Homebrew** (macOS package manager)
- 🛠 **CLI Tools**: `git`, `gh` (GitHub CLI), `fzf`, `ripgrep`, `wget`, `jq`
### **Development**
- ⚡ **Volta** (for Node.js version management)
- 🟢 **Node.js** (via Volta) + Global npm packages (`pnpm`, `yarn`, `eslint`, `typescript`)
- 🐘 **PHP** (for WordPress & Shopify work)
- 🎠 **Composer** (PHP package manager)
### **Shell & Configs**
- 🎨 **Cursor settings** (symlinked for automatic syncing)
- 🛠 **Git config** (`.gitconfig`)
- 🐛 **Zsh config** (`.zshrc`)
- ⚡ **Oh My Zsh & Plugins**
- `zsh-autosuggestions` (auto-suggest commands)
- `zsh-syntax-highlighting` (colorized command syntax)
---
## 📌 **Updating Your Dotfiles**
Whenever you change settings, run:
```sh
cd ~/dotfiles
git add .
git commit -m "Update dotfiles"
git push
```
---
## 🛠 **Customizing**
### **Adding More Tools**
- Modify `install.sh` to install additional CLI tools or frameworks (e.g., VS Code, Docker).
- Add custom **aliases, functions, and environment variables** to `~/.zshrc`.
### **Changing Cursor Settings**
Modify `settings.json` and run:
```sh
cp ~/Library/Application\ Support/Cursor/User/settings.json ~/dotfiles/
git add settings.json
git commit -m "Update Cursor settings"
git push
```
---
## 🚑 **Troubleshooting**
### **1⃣ "Permission denied" when running the script**
Fix it by making the script executable:
```sh
chmod +x ~/dotfiles/install.sh
```
### **2⃣ Homebrew is asking for a password**
That’s normal—Homebrew requires admin permissions for system-wide installs.
### **3⃣ Symlinked files aren’t updating**
Run:
```sh
ln -sf ~/dotfiles/.zshrc ~/.zshrc
ln -sf ~/dotfiles/.gitconfig ~/.gitconfig
ln -sf ~/dotfiles/settings.json ~/Library/Application\ Support/Cursor/User/settings.json
```
This will **re-link everything manually**.
---
## 📌 **Next Steps**
- **Keep your dotfiles updated** by committing changes regularly
- **Share your setup** with friends who want a similar Mac dev environment
- **Fork & modify** if you want to create a custom version
🚀 **This is now a plug-and-play Mac setup! Enjoy.** 🎉