# dotfiles, plus scripts for box setup

### prereqs
- zsh and git installed
- 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 [ref/macos-system-settings](ref/macos-system-settings.txt)

### script run
- (run these commands from repo's root dir)
- to do the full setup, run: `./box_setup.sh <OS-name>`
- to copy dotfiles only, run: `./copy_dotfiles.sh`
    - NOTE: the `copy_dotfiles.sh` script may not work if ENV vars are not set as expected

### after script run
- complete manual actions specified in [ref/post-run-manual](ref/post-run-manual.md)

### todo items
- choose window manager for linux, then configure
- config for: terminal (ghostty); shell; mpd, mpc, ncmpcpp; mpv
- decide on and implement approach for languages and versioning
    - language-specific? asdf? no, not asdf, mise seems better from what i hear so far
    - docker? or alternatives like podman? any license concerns?