Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nunorafaelrocha/dotfiles
🖥️ 🚀 Your dotfiles are how you personalize your system. These are mine. 😎
https://github.com/nunorafaelrocha/dotfiles
automation developer-tools dotfiles dotfiles-automation dotfiles-install dotfiles-installer dotfiles-linux dotfiles-macos dotfiles-manager homebrew linux macos osx system system-automation ubuntu zsh
Last synced: 3 months ago
JSON representation
🖥️ 🚀 Your dotfiles are how you personalize your system. These are mine. 😎
- Host: GitHub
- URL: https://github.com/nunorafaelrocha/dotfiles
- Owner: nunorafaelrocha
- License: mit
- Created: 2018-10-07T20:20:26.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2022-12-15T14:50:45.000Z (about 2 years ago)
- Last Synced: 2024-10-30T21:37:53.258Z (3 months ago)
- Topics: automation, developer-tools, dotfiles, dotfiles-automation, dotfiles-install, dotfiles-installer, dotfiles-linux, dotfiles-macos, dotfiles-manager, homebrew, linux, macos, osx, system, system-automation, ubuntu, zsh
- Language: Shell
- Homepage:
- Size: 409 KB
- Stars: 37
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome - dotfiles - Your dotfiles are how you personalize your system. These are Nuno's, fork it and boost your productivity :rocket: (Miscellaneous)
README
# 🚀 Nuno's Dotfiles
Your dotfiles are how you personalize your system. These are mine. :sunglasses:
**Supported Operating Systems**
| OS | Version | CI |
| ------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| macOS | Mojave (10.14)
Catalina (10.15)
Big Sur (11.0) |  |
| Ubuntu | Bionic Beaver (18.04)
Focal Fossa (20.04) | [](https://circleci.com/gh/nunorafaelrocha/dotfiles) |
## 🔧 Installation
**via curl**
```sh
bash -c "$(curl -fsSL https://raw.githubusercontent.com/nunorafaelrocha/dotfiles/main/bin/dot)"
```
**via git**
```sh
git clone --recursive https://github.com/nunorafaelrocha/dotfiles ~/.dotfiles
cd ~/.dotfiles
./bin/dot
```
## 🔁 Update
`dot` is a simple script that installs some dependencies, sets sane macOS
defaults, and so on. Tweak this script, and occasionally run `dot` from
time to time to keep your environment fresh and up-to-date. You can find
this script in `bin/`.
## 💄 Customization
Everything is configured and tweaked within `~/.dotfiles`.
The main file you'll want to change right off the bat is `zsh/zshrc.symlink`,
which sets up a few paths that'll be different on your particular machine.
### topics
Everything's built around topic areas. If you're adding a new area to your
forked dotfiles — say, "node" — you can simply add a `node` directory and put
files in there. Anything with an extension of `.zsh` will get automatically
included into your shell. Anything with an extension of `.symlink` will get
symlinked without extension into `$HOME` when you run `dot` or `dot --link`.
### components
There's a few special files in the hierarchy.
- **bin/**: Anything in `bin/` will get added to your `$PATH` and be made
available everywhere.
- **Brewfile**: This is a list of applications for [Homebrew Cask](https://caskroom.github.io) to install: things like Chrome and 1Password and stuff. Might want to edit this file before running any initial setup.
- **topic/\*.zsh**: Any files ending in `.zsh` get loaded into your
environment.
- **topic/path.zsh**: Any file named `path.zsh` is loaded first and is
expected to setup `$PATH` or similar.
- **topic/completion.zsh**: Any file named `completion.zsh` is loaded
last and is expected to setup autocomplete.
- **topic/install.sh**: Any file named `install.sh` is executed when you run `dot` or `dot --install`. To avoid being loaded automatically, its extension is `.sh`, not `.zsh`.
- **topic/\*.symlink**: Any file ending in `*.symlink` gets symlinked into
your `$HOME`. This is so you can keep all of those versioned in your dotfiles
but still keep those autoloaded files in your home directory. These get
symlinked in when you run `dot` or `dot --link`.
## 🙏 thanks
I forked [Zach Holman](https://github.com/holman)'s awesome
[dotfiles](https://github.com/holman/dotfiles) which were an easy way to start my own customization.