Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngshiheng/dotfiles
Personal dotfiles
https://github.com/ngshiheng/dotfiles
chezmoi dotfiles
Last synced: 3 months ago
JSON representation
Personal dotfiles
- Host: GitHub
- URL: https://github.com/ngshiheng/dotfiles
- Owner: ngshiheng
- Created: 2022-02-06T10:42:09.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-13T04:01:40.000Z (6 months ago)
- Last Synced: 2024-07-14T04:46:51.443Z (6 months ago)
- Topics: chezmoi, dotfiles
- Language: Shell
- Homepage: https://s.jerrynsh.com/dotfiles
- Size: 124 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Jerry's dotfiles
These dotfiles are managed using [chezmoi](https://www.chezmoi.io/).
Upon fresh installation, the [`run_once_install-packages.sh`](run_once_install-packages.sh) (idempotent and POSIX compliant) script would be executed once.
## What I use
| Tools | Description |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| Terminal emulator | [Windows Terminal](https://github.com/microsoft/terminal) (on WSL2) & [iTerm2](https://iterm2.com/) |
| Package manager | [Homebrew](https://brew.sh/) |
| Unix shell | [Z shell](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH) |
| Zsh theme | [Powerlevel10k](https://github.com/romkatv/powerlevel10k) |
| Dotfiles manager | [chezmoi](https://chezmoi.io/) |
## Getting started
Check out the [Quick Start](https://www.chezmoi.io/quick-start/) page.
### Install chezmoi and the dotfiles on any new machine
With a single command:
```sh
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply ngshiheng
```
### Update
On any machine, you can pull and apply the latest changes from your repo with:
```sh
chezmoi update -v
```
### Prompts
For [managing machine-to-machine differences](https://www.chezmoi.io/user-guide/manage-machine-to-machine-differences/).
To add/remove/edit prompts:
```sh
vim ~/.local/share/chezmoi/.chezmoi.toml.tmpl
```
To test templates, use `chezmoi execute-template < dot_gitconfig.tmpl` ([ref](https://www.chezmoi.io/user-guide/templating/#testing-templates)).
### `run_once_install-packages.sh` script
The [`run_once_install-packages.sh`](run_once_install-packages.sh) script runs with the following assumptions (i.e. requirements):
- `bash` is installed; this is so that it can install [Homebrew](https://brew.sh/).
- `zsh` as the default Unix shell of choice.
Check out the [Understand How Scripts Work](https://www.chezmoi.io/user-guide/use-scripts-to-perform-actions/#understand-how-scripts-work) page.
## Reference
[How To Manage Dotfiles With Chezmoi](https://jerrynsh.com/how-to-manage-dotfiles-with-chezmoi/)