# dotfiles, plus installation and related scripts

This repo contains a collection of scripts and files related to:

- configuration (i.e. this serves as my dotfiles repo)
- installation of programs
- scripts/executables for my local systems
- anything else related to getting my boxes (computers) set up as desired

This repo grew into more than I originally intended, but it turned into a fun little
excursion into the realm of shell scripting (and an intro to Lua for the neovim
portions).

## prereqs

- programs installed: git, sed, zsh
- git clone this repo

### specific prereqs, linux distros

- sudo access is configured for current user

### specific prereqs, macos

- install the package manager, [homebrew](https://brew.sh/)
- for aerospace window manager, have only 1 workspace/desktop
- manual settings, refer to [docs/macos-system-settings](docs/macos-system-settings.md)

## script run

- to do the full setup, from the repo's root dir, run: `./box_setup.sh`
- to copy dotfiles only, from the repo's root dir, run: `./copy_dotfiles.sh`

## after script run

- complete manual actions specified in [docs/post-run](docs/post-run.md)

## todo items

see [docs/todo.md](docs/todo.md)

## attribution

see [docs/attribution.md](docs/attribution.md)