{"id":26468603,"url":"https://github.com/mattdowney/dotfiles","last_synced_at":"2025-12-30T19:05:33.919Z","repository":{"id":283177678,"uuid":"950907299","full_name":"mattdowney/dotfiles","owner":"mattdowney","description":"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.","archived":false,"fork":false,"pushed_at":"2025-03-18T23:20:07.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T00:26:03.964Z","etag":null,"topics":["composer","dev-environment","dotfiles","homebrew","macos","nodejs","php","setup-script","volta","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattdowney.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-03-18T21:37:28.000Z","updated_at":"2025-03-18T23:20:10.000Z","dependencies_parsed_at":"2025-03-19T00:26:08.098Z","dependency_job_id":"fa10daad-ca73-4b5e-a528-fd05bfad4b86","html_url":"https://github.com/mattdowney/dotfiles","commit_stats":null,"previous_names":["mattdowney/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdowney%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdowney%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdowney%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdowney%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattdowney","download_url":"https://codeload.github.com/mattdowney/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244460247,"owners_count":20456301,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["composer","dev-environment","dotfiles","homebrew","macos","nodejs","php","setup-script","volta","zsh"],"created_at":"2025-03-19T16:14:31.728Z","updated_at":"2025-12-30T19:05:33.881Z","avatar_url":"https://github.com/mattdowney.png","language":"Shell","readme":"# 🚀 Dotfiles \u0026 Dev Environment Setup\n\nThis repository contains my **dotfiles** and a fully automated **install script** to set up a macOS development environment in minutes.\n\n## 📌 **Installation Instructions**\n\n### **1⃣ Clone the Dotfiles Repo**\n```sh\ngit clone git@github.com:mattdowney/dotfiles.git ~/dotfiles\n```\n\n### **2⃣ Run the Install Script**\n```sh\nbash ~/dotfiles/install.sh\n```\n\n### **3⃣ Restart Your Terminal**\n```sh\nexec zsh\n```\nOr manually close and reopen your terminal.\n\n---\n\n## ⚡ **What This Installs**\n### **System Tools**\n- 🍺 **Homebrew** (macOS package manager)\n- 🛠 **CLI Tools**: `git`, `gh` (GitHub CLI), `fzf`, `ripgrep`, `wget`, `jq`\n\n### **Development**\n- ⚡ **Volta** (for Node.js version management)\n- 🟢 **Node.js** (via Volta) + Global npm packages (`pnpm`, `yarn`, `eslint`, `typescript`)\n- 🐘 **PHP** (for WordPress \u0026 Shopify work)\n- 🎠 **Composer** (PHP package manager)\n\n### **Shell \u0026 Configs**\n- 🎨 **Cursor settings** (symlinked for automatic syncing)\n- 🛠 **Git config** (`.gitconfig`)\n- 🐛 **Zsh config** (`.zshrc`)\n- ⚡ **Oh My Zsh \u0026 Plugins**\n  - `zsh-autosuggestions` (auto-suggest commands)\n  - `zsh-syntax-highlighting` (colorized command syntax)\n\n---\n\n## 📌 **Updating Your Dotfiles**\nWhenever you change settings, run:\n```sh\ncd ~/dotfiles\ngit add .\ngit commit -m \"Update dotfiles\"\ngit push\n```\n\n---\n\n## 🛠 **Customizing**\n### **Adding More Tools**\n- Modify `install.sh` to install additional CLI tools or frameworks (e.g., VS Code, Docker).\n- Add custom **aliases, functions, and environment variables** to `~/.zshrc`.\n\n### **Changing Cursor Settings**\nModify `settings.json` and run:\n```sh\ncp ~/Library/Application\\ Support/Cursor/User/settings.json ~/dotfiles/\ngit add settings.json\ngit commit -m \"Update Cursor settings\"\ngit push\n```\n\n---\n\n## 🚑 **Troubleshooting**\n### **1⃣ \"Permission denied\" when running the script**\nFix it by making the script executable:\n```sh\nchmod +x ~/dotfiles/install.sh\n```\n\n### **2⃣ Homebrew is asking for a password**\nThat’s normal—Homebrew requires admin permissions for system-wide installs.\n\n### **3⃣ Symlinked files aren’t updating**\nRun:\n```sh\nln -sf ~/dotfiles/.zshrc ~/.zshrc\nln -sf ~/dotfiles/.gitconfig ~/.gitconfig\nln -sf ~/dotfiles/settings.json ~/Library/Application\\ Support/Cursor/User/settings.json\n```\nThis will **re-link everything manually**.\n\n---\n\n## 📌 **Next Steps**\n- **Keep your dotfiles updated** by committing changes regularly  \n- **Share your setup** with friends who want a similar Mac dev environment  \n- **Fork \u0026 modify** if you want to create a custom version  \n\n🚀 **This is now a plug-and-play Mac setup! Enjoy.** 🎉","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattdowney%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattdowney%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattdowney%2Fdotfiles/lists"}