Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicksp/dotfiles
My personal dotfiles: Zsh, Git, VSCode, WezTerm, etc.
https://github.com/nicksp/dotfiles
configuration dotfiles environment fzf ghostty git homebrew lazydocker lazygit macos starship-prompt unix vscode zsh
Last synced: 3 days ago
JSON representation
My personal dotfiles: Zsh, Git, VSCode, WezTerm, etc.
- Host: GitHub
- URL: https://github.com/nicksp/dotfiles
- Owner: nicksp
- License: mit
- Created: 2016-03-20T02:31:23.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2025-02-08T19:03:28.000Z (11 days ago)
- Last Synced: 2025-02-10T09:03:25.258Z (10 days ago)
- Topics: configuration, dotfiles, environment, fzf, ghostty, git, homebrew, lazydocker, lazygit, macos, starship-prompt, unix, vscode, zsh
- Language: Shell
- Homepage: https://github.com/nicksp/dotfiles
- Size: 13.3 MB
- Stars: 360
- Watchers: 15
- Forks: 96
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - nicksp/dotfiles - My personal dotfiles: Zsh, Git, VSCode, WezTerm, etc. (Shell)
README
# ~nicksp 🌮
My personal dotfiles for configuring macOS with Zsh and Homebrew.
> [!IMPORTANT]
> Please only open pull requests that fix bugs or add improvements without any breaking changes.
> [!WARNING]
> I recommend forking this repository to create your own set of dotfiles.
## Requirements
- macOS
- Homebrew (the install script will install Homebrew)
- Zsh (the install script will install Zsh via Homebrew)
## What's in there?
- Handy [binary scripts](bin/).
- [Custom color scheme](colors/).
- [Custom zsh theme](tilde/.starship.toml) with Git status, etc. using [Starship](https://starship.rs/).
- [Git aliases](tilde/.gitconfig).
- [Shell aliases](zsh/aliases.zsh).
- zsh / [fzf](zsh/fzf.zsh).
- git / delta syntax-highlighting diff tool.
- Sensible [macOS defaults](setup/macos.sh).
- Config for other apps and utils.
- [macOS apps and VSCode extensions](setup/Brewfile) I use.
- [macOS tips & tricks](/docs/macOS%20Tips%20&%20Tricks.md).
## Installation
1. Enable **Firewall** under **System Settings** → **Network**
1. Point the DNS Servers to [Cloudflare DNS](https://one.one.one.one/dns/)
- `1.1.1.1`
- `1.0.0.1`
- `2606:4700:4700::1111`
- `2606:4700:4700::1001`
1. Configure Git and GitHub SSH
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)
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)
1. Test your authentication with:
```
ssh -T [email protected]
```
1. Install [MonoLisa font](https://www.monolisa.dev/)
1. Choose _manual_ or _automatic_ dotfiles installation below
### Manually
```shell
git clone [email protected]:nicksp/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup/zsh.sh
./setup/brew.sh
./setup/misc.sh
./setup/symlinks.sh
```
### Automatically
To automate the setup of your dotfiles on a new machine, use the [setup](./setup.sh) script.
> [!CAUTION]
> Use at your own risk!
```shell
git clone [email protected]:nicksp/dotfiles.git ~/dotfiles
~/dotfiles/setup.sh
```
This will install all required dotfiles in your home directory as symlinks. Everything is then configured via modifying files in `~/dotfiles`.
## Extras
### Set macOS defaults
```shell
set-defaults
```
### Use alternative apps icons
```shell
sync-apps-icons
```
### Install colors themes
```shell
sync-color-themes
```
## Local customizations
The dotfiles can be extended to suit additional local
requirements by using the following files:
#### `~/.zsh.local`
If this file exists, it will be automatically sourced
after all the other shell related files allowing its
content to add to or overwrite the existing aliases, settings, PATH,
etc.
#### `~/.gitconfig.local`
If this file exists, it will be automatically
included after the configurations from `~/.gitconfig` allowing
its content to overwrite or add to the existing `git` configurations.
> [!TIP]
> Use `~/.gitconfig.local` to store sensitive information such
as the `git` user credentials for individual repositories.
## Updating
To update an existing install:
```shell
cd ~/dotfiles
git pull
./setup.sh
```
## License
MIT License.
## Inspiration
- [holman/dotfiles](https://github.com/holman/dotfiles)
- [mathiasbynes/dotfiles](https://github.com/mathiasbynens/dotfiles)
- [sapegin/dotfiles](https://github.com/sapegin/dotfiles)
-
-
-
-