https://github.com/thisislawatts/dotfiles

macOS configuration
https://github.com/thisislawatts/dotfiles

Last synced: about 1 month ago
JSON representation

macOS configuration

• Host: GitHub
• URL: https://github.com/thisislawatts/dotfiles
• Owner: thisislawatts
• License: mit
• Created: 2021-03-19T20:31:47.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-03-04T14:10:11.000Z (9 months ago)
• Last Synced: 2024-06-12T19:04:57.702Z (5 months ago)
• Language: Shell
• Homepage:
• Size: 43 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# dotfiles

## topics and components

Everything's built around topic areas. If you're adding a new area to your

forked dotfiles — say, "CaptainPlanet" — you can simply add a `captain-planet` 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 `script/bootstrap`.

There's a few special files in the hierarchy.

- **bin/**: Anything in `bin/` will get added to your `$PATH` and be made

  available everywhere.

- **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 `script/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 `script/bootstrap`.

## install

Run this:

```sh

git clone https://github.com/thisislawatts/dotfiles.git ~/.dotfiles

cd ~/.dotfiles

script/bootstrap

```

This will symlink the appropriate files in `.dotfiles` to your home directory.

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.

`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/`.

## 🙇🏻‍♂️ thanks

Almost entirely lifted from [Zach Holman](https://github.com/holman/dotfiles)