{"id":15715976,"url":"https://github.com/samueldosramos/dotfiles","last_synced_at":"2025-08-20T15:09:30.171Z","repository":{"id":180652453,"uuid":"93358602","full_name":"samueldosramos/dotfiles","owner":"samueldosramos","description":"macOS Dotfiles - Easily configure macOS","archived":false,"fork":false,"pushed_at":"2024-07-28T13:23:34.000Z","size":12097,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-08T16:56:21.718Z","etag":null,"topics":["bash","brew","cask","dotfiles","macos","oh-my-zsh","terminal","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samueldosramos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2017-06-05T02:51:16.000Z","updated_at":"2024-07-28T13:16:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"34b5b08b-04d9-4296-9242-836219a929e1","html_url":"https://github.com/samueldosramos/dotfiles","commit_stats":null,"previous_names":["samuelramox/dotfiles","samueldosramos/dotfiles"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samueldosramos%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samueldosramos%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samueldosramos%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samueldosramos%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samueldosramos","download_url":"https://codeload.github.com/samueldosramos/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253112074,"owners_count":21856070,"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":["bash","brew","cask","dotfiles","macos","oh-my-zsh","terminal","zsh"],"created_at":"2024-10-03T21:43:43.822Z","updated_at":"2025-08-20T15:09:30.165Z","avatar_url":"https://github.com/samueldosramos.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macOS Dotfiles\n\nThis is a simple and flexible dotfiles and scripts to setup _macOS_.\n\n## Table of Contents\n\n1. [What are dotfiles][]\n1. [Features][]\n1. [Installation][]\n1. [Manual setup][]\n1. [Resources][]\n\n## What are dotfiles\n\nDotfiles are configuration files on Unix-based systems. At first they are just hidden configuration files of the system (that's why the reason for starting with `.`). However, we can use them to make it easier to configure our computers, with many advantages:\n\n- Easy to format a new computer\n- Automation of tasks\n- Easy maintenance\n- Storage in remote locations (GitHub, iCloud, Dropbox, etc)\n- Versioning\n- Import to multiple computers\n- Customize the terminal\n\n## Features\n\n_Check linked files to more details._\n\n### Installation files\n\n- [apps.sh][] - installs _Homebrew_, _Homebrew Cask Upgrade_ and some _apps_.\n- [dock.sh][] - macOS Dock items customization.\n- [dotfiles.sh][] - installs _Oh My Zsh_, _.zshrc_ and _Git_ configs.\n- [hostname.sh][] - change _hostname_ (MacBook name).\n- [macos.sh][] - macOS defaults configs.\n- [npm.sh][] - install _npm_ packages.\n- [setup.sh][] - main installer.\n- [ssh.sh][] - generate _SSH_.\n- [user.sh][] - user data to configuration of _Git_ and _SSH_.\n- [util.sh][] - support functions for other installers.\n\n**Note:** _These files will be discarded later._\n\n### Settings Files\n\n- [.gitignore_global][] - global _gitignore_.\n- [.zshrc_intel][] - terminal configs with aliases, paths, plugins and theme for Macs with _Intel_.\n- [.zshrc_silicon][] - terminal configs with aliases, paths, plugins and theme for Macs with _Apple Silicon_.\n- [starship.toml][] - [Starship][] theme settings.\n\n**Note:** _These files are permanent_.\n\n## Installation\n\n```bash\ngit clone https://github.com/samuelramox/dotfiles.git \u0026\u0026 cd dotfiles\n\n./setup.sh\n```\n\n**Note:** You can also download a specific [release][].\n\n### Explaining the process\n\nThe [setup.sh][] process will open [user.sh][] for you to add your user data. This data is necessary for the configuration and functioning of Git and SSH.\n\n```bash\n# - GIT_NAME: name and surname to use in Git settings.\n# - GIT_EMAIL: email to use in Git settings.\n# - SSH_EMAIL: email to use in SSH settings.\n# - HOSTNAME: hostname/computer name (optional, leave empty if you don't want to change).\n```\n\nIt will then install the following scripts, in this order:\n\n- [apps.sh][] - install _Homebrew_, _Homebrew Cask Upgrade_ and applications.\n\n  - Install [Homebrew][].\n  - Homebrew formulas: [asdf][], [curl][], [Git][], [Nano][], [Node][], [PostgreSQL][], [Python][], [Ruby][], [Tree][], [Yarn][], [Zsh][].\n  - Homebrew taps: [homebrew/fonts][], [homebrew/drivers][], [homebrew/versions][], [homebrew/command-not-found][].\n  - Homebrew casks: [Google Chrome][], [IINA][], [JetBrains Mono][] and [Visual Studio Code][].\n  - Install [Homebrew Cask Upgrade][].\n\n- [dotfiles.sh][] - install [Oh My Zsh][], some Zsh plugins, [Starship][] theme and set **.gitconfig**.\n- [npm.sh][] - install some npm packages.\n- [macos.sh][] - set custom macOS preferences.\n- [dock.sh][] - install [dockutil][] and set custom permanent apps in Dock. _Finder_ and _Recycle Bin_ are already permanent (unless you change this).\n- [ssh.sh][] - Generate _SSH_.\n- [hostname.sh][] - Update _hostname_ (MacBook name).\n- Create a directory called _Developer_ in _Home_ directory for projects and development.\n- Cleanup cached downloads and remove the installation zip and folder.\n\n**Note:** I suggest you read these files and turn your preferences on/off before installation.\n\n## Manual setup\n\n[Visual Studio Code][] settings are loaded by the [Settings Sync][], so you will have to change manually or load your settings.\n\n### Visual Studio Code - Config\n\n`Code → Preference → Settings (or CMD + ,) and add or edit the following values:`\n\n```json\n\"editor.fontFamily\": \"JetBrains Mono\",\n\"editor.fontLigatures\": true,\n```\n\n## Resources\n\n- [Dotfiles Repositories][]\n- [Awesome Dotfiles][]\n- [Homebrew][]\n- [Homebrew Cask Upgrade][]\n- [Dockutil][]\n- [Sensible macOS defaults][]\n- [Awesome OSX Command Line][]\n- [Oh My Zsh][]\n- [Starship][]\n\n[.gitignore_global]: configs/gitignore_global\n[.zshrc_intel]: configs/.zshrc_intel\n[.zshrc_silicon]: configs/.zshrc_silicon\n[apps.sh]: scripts/apps.sh\n[asdf]: https://asdf-vm.com\n[awesome dotfiles]: https://github.com/webpro/awesome-dotfiles\n[awesome osx command line]: https://github.com/herrbischoff/awesome-osx-command-line\n[curl]: https://curl.haxx.se\n[dock.sh]: scripts/dock.sh\n[dockutil]: https://github.com/kcrawford/dockutil\n[dotfiles.sh]: scripts/dotfiles.sh\n[dotfiles repositories]: https://dotfiles.github.io/\n[features]: #features\n[git]: https://git-scm.com\n[google chrome]: https://www.google.com/chrome/\n[homebrew]: https://brew.sh/\n[homebrew cask upgrade]: https://github.com/buo/homebrew-cask-upgrade\n[homebrew/command-not-found]: https://github.com/Homebrew/homebrew-command-not-found\n[homebrew/drivers]: https://github.com/Homebrew/homebrew-cask-drivers\n[homebrew/fonts]: https://github.com/Homebrew/homebrew-cask-fonts\n[homebrew/versions]: https://github.com/Homebrew/homebrew-cask-versions\n[hostname.sh]: scripts/hostname.sh\n[iina]: https://iina.io/\n[installation]: #installation\n[jetbrains mono]: https://jetbrains.com/mono\n[macos.sh]: scripts/macos.sh\n[manual setup]: #manual-setup\n[nano]: https://www.nano-editor.org\n[node]: https://nodejs.org/\n[npm.sh]: scripts/npm.sh\n[oh my zsh]: https://ohmyz.sh\n[postgresql]: https://www.postgresql.org\n[python]: https://www.python.org\n[release]: https://github.com/samuelramox/dotfiles/releases\n[resources]: #resources\n[ruby]: https://www.ruby-lang.org/\n[sensible macos defaults]: https://github.com/mathiasbynens/dotfiles/blob/master/.macos\n[settings sync]: https://code.visualstudio.com/docs/editor/settings-sync\n[setup.sh]: scripts/setup.sh\n[starship]: https://starship.rs\n[starship.toml]: configs/starship.toml\n[ssh.sh]: scripts/ssh.sh\n[tree]: http://mama.indstate.edu/users/ice/tree/\n[user.sh]: scripts/user.sh\n[util.sh]: scripts/util.sh\n[visual studio code]: https://code.visualstudio.com\n[what are dotfiles]: #what-are-dotfiles\n[yarn]: https://yarnpkg.com/\n[zsh]: https://www.zsh.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamueldosramos%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamueldosramos%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamueldosramos%2Fdotfiles/lists"}