{"id":13880596,"url":"https://github.com/nicksp/dotfiles","last_synced_at":"2025-05-16T04:02:34.735Z","repository":{"id":47458812,"uuid":"54296863","full_name":"nicksp/dotfiles","owner":"nicksp","description":"My personal dotfiles: Zsh, Git, VSCode, WezTerm, etc.","archived":false,"fork":false,"pushed_at":"2025-04-22T15:13:31.000Z","size":13893,"stargazers_count":365,"open_issues_count":0,"forks_count":95,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-22T16:32:23.416Z","etag":null,"topics":["configuration","dotfiles","environment","fzf","ghostty","git","homebrew","lazydocker","lazygit","macos","starship-prompt","unix","vscode","zsh"],"latest_commit_sha":null,"homepage":"https://github.com/nicksp/dotfiles","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/nicksp.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,"zenodo":null}},"created_at":"2016-03-20T02:31:23.000Z","updated_at":"2025-04-22T15:13:35.000Z","dependencies_parsed_at":"2024-08-19T13:15:04.886Z","dependency_job_id":"c854b3b1-f136-4983-bc43-7a5c23ffd731","html_url":"https://github.com/nicksp/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicksp%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicksp%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicksp%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicksp%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicksp","download_url":"https://codeload.github.com/nicksp/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254464891,"owners_count":22075570,"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":["configuration","dotfiles","environment","fzf","ghostty","git","homebrew","lazydocker","lazygit","macos","starship-prompt","unix","vscode","zsh"],"created_at":"2024-08-06T08:03:15.680Z","updated_at":"2025-05-16T04:02:29.710Z","avatar_url":"https://github.com/nicksp.png","language":"Shell","readme":"# ~nicksp 🌮\n\nMy personal dotfiles for configuring macOS with Zsh and Homebrew.\n\n![nicksp terminal](screenshot.png)\n\n\u003e [!IMPORTANT]\n\u003e Please only open pull requests that fix bugs or add improvements without any breaking changes.\n\n\u003e [!WARNING]\n\u003e I recommend forking this repository to create your own set of dotfiles.\n\n## Requirements\n\n- macOS\n- Homebrew (the install script will install Homebrew)\n- Zsh (the install script will install Zsh via Homebrew)\n\n## What's in there?\n\n- Handy [binary scripts](bin/).\n- [Custom color scheme](colors/).\n- [Custom zsh theme](tilde/.starship.toml) with Git status, etc. using [Starship](https://starship.rs/).\n- [Git aliases](tilde/.gitconfig).\n- [Shell aliases](zsh/aliases.zsh).\n- zsh / [fzf](zsh/fzf.zsh).\n- git / delta syntax-highlighting diff tool.\n- Sensible [macOS defaults](setup/macos.sh).\n- Config for other apps and utils.\n- [macOS apps and VSCode extensions](setup/Brewfile) I use.\n- [macOS tips \u0026 tricks](/docs/macOS%20Tips%20\u0026%20Tricks.md).\n\n## Installation\n\n1. Point the DNS Servers to [Cloudflare DNS](https://one.one.one.one/dns/)\n    - `1.1.1.1`\n    - `1.0.0.1`\n    - `2606:4700:4700::1111`\n    - `2606:4700:4700::1001`\n1. Configure Git and GitHub SSH\n    1. [Generate SSH key and add it to the ssh-agent](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)\n    1. [Add your public SSH key to GitHub account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)\n    1. Test your authentication with:\n\n        ```\n        ssh -T git@github.com\n        ```\n\n1. Configure [GPG commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification#gpg-commit-signature-verification)\n1. Install [MonoLisa font](https://www.monolisa.dev/)\n1. Choose _manual_ or _automatic_ dotfiles installation below\n\n### Manually\n\n```shell\ngit clone git@github.com:nicksp/dotfiles.git ~/dotfiles\ncd ~/dotfiles\n./setup/zsh.sh\n./setup/brew.sh\n./setup/misc.sh\n./setup/symlinks.sh\n```\n\n### Automatically\n\nTo automate the setup of your dotfiles on a new machine, use the [setup](./setup.sh) script.\n\n\u003e [!CAUTION]\n\u003e Use at your own risk!\n\n```shell\ngit clone git@github.com:nicksp/dotfiles.git ~/dotfiles\n~/dotfiles/setup.sh\n```\n\nThis will install all required dotfiles in your home directory as symlinks. Everything is then configured via modifying files in `~/dotfiles`.\n\n## Extras\n\n### Set macOS defaults\n\n```shell\nset-defaults\n```\n\n### Use alternative apps icons\n\n```shell\nsync-apps-icons\n```\n\n### Install colors themes\n\n```shell\nsync-color-themes\n```\n\n## Local customizations\n\nThe dotfiles can be extended to suit additional local\nrequirements by using the following files:\n\n#### `~/.zsh.local`\n\nIf this file exists, it will be automatically sourced\nafter all the other shell related files allowing its\ncontent to add to or overwrite the existing aliases, settings, PATH,\netc.\n\n#### `~/.gitconfig.local`\n\nIf this file exists, it will be automatically\nincluded after the configurations from `~/.gitconfig` allowing\nits content to overwrite or add to the existing `git` configurations.\n\n\u003e [!TIP]\n\u003e Use `~/.gitconfig.local` to store sensitive information such\nas the `git` user credentials for individual repositories.\n\n## Updating\n\nTo update an existing install:\n\n```shell\ncd ~/dotfiles\ngit pull\n./setup.sh\n```\n\n## License\n\nMIT License.\n\n## Inspiration\n\n- [holman/dotfiles](https://github.com/holman/dotfiles)\n- [mathiasbynes/dotfiles](https://github.com/mathiasbynens/dotfiles)\n- [sapegin/dotfiles](https://github.com/sapegin/dotfiles)\n- \u003chttps://remysharp.com/2018/08/23/cli-improved\u003e\n- \u003chttps://evanhahn.com/a-decade-of-dotfiles/\u003e\n- \u003chttps://cpojer.net/posts/set-up-a-new-mac-fast\u003e\n- \u003chttps://thevaluable.dev/zsh-install-configure-mouseless/\u003e\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicksp%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicksp%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicksp%2Fdotfiles/lists"}