Dotfiles

This repo uses rotz to bootstrap and manage the configuration files (dotfiles). It works cross-platform on Windows, MacOS, and Linux.

Expected dependencies

These should be installed first.

• Homebrew
• git (usually via brew)

Setup

Currently rotz requires git to be installed as a pre-requisite.

1. Download the latest release for your platform.
   • Homebrew via volllly/tap: brew tap volllly/tap then brew install rotz
   • Windows
   • MacOS Intel
   • Linux
2. Unpack the rotz binary. Optionally place this in a location on your PATH.
3. Run rotz clone [email protected]:pho3nixf1re/dotfiles.git

Usage

To link dotfiles:

rotz link

To install dependencies:

rotz install

If you are on MacOS or Linux you may want to install all of the dependencies. Be sure to run the link step first.

brew bundle --global

To update dotfiles:

rotz sync

Shell dependencies

These should install using rotz install.

• zshell: brew install zsh
  • on linux it may be best to use native package then run chsh -s /path/to/zsh
• homebrew which is also available on linux:

  curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

• starship: brew install starship
• nvim: brew install neovim
• spacevim: curl -sLf https://spacevim.org/install.sh | bash

Git commit signing

1. Install 1password.
2. Copy GitHub ssh fingerprint from 1password.
3. Add to user settings in .gitconfig-local which is not checked in here.

   [user]
   signingkey = ssh-ed25519 AAAA...

Environment secrets

Place environment secrets into the local user files (.config/zsh/*.zsh, .config/powershell/profile.d/*.ps1). These will not live here except to be documented if needed during shell initialization.