vercel-composition-patterns

If you've already got your dotfiles setup you can use the following commands to manage your dotfiles.

Updating dotfiles

#### Track file

```sh

dotfiles add -f .somefile

```

#### Untrack file

```sh

dotfiles rm --cached .somefile

```

Managing system

#### macOS (nix-darwin)

Build and activate nix-darwin config. This will make changes to the system and update packages as per [flake.nix](.config/nix/flake.nix)

```sh

darwin-rebuild switch --flake ~/.config/nix

# alias: drs

```

Update nix packages. This will update your non-homebrew packages and update [flake.lock](.config/nix/flake.lock)

```sh

nix flake update --flake ~/.config/nix

# alias: nfu

# You need to run build and activate after i.e. drs

```

Update brew packages

```sh

brew upgrade

```

Update mise packages

```sh

mise upgrade

```

#### Linux (home-manager)

Build and activate home-manager config. This will update packages as per [flake.nix](.config/nix/flake.nix)

```sh

home-manager switch --flake ~/.config/nix

# alias: hms

```

Update nix packages. This will update your packages and update [flake.lock](.config/nix/flake.lock)

```sh

nix flake update --flake ~/.config/nix

# alias: nfu

# You need to run home-manager switch after i.e. hms

```

Update mise packages

```sh

mise upgrade

```

Setup (from this repo)

If you want to (fork and) clone this repo and use it for your own dotfiles, follow these steps.

1. Clone repo

```sh

DOTFILES_REPO=https://github.com/connorads/dotfiles/

DOTFILES_DIR=$HOME/git/dotfiles

git clone --bare $DOTFILES_REPO $DOTFILES_DIR

```

1. Change worktree to home directory

```sh

cd $DOTFILES_DIR

git config --unset core.bare

git config core.worktree $HOME

```

1. Put dotfiles from git into home directory (⚠️ this will overwrite existing dotfiles in home directory)

```sh

cd $HOME

git --git-dir=$DOTFILES_DIR/ checkout -f

```

1. Setup nix, brew and install software (⚠️ skip the option to install Determinate Nix)

macOS (nix-darwin):

```sh

# Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

eval "$(/opt/homebrew/bin/brew shellenv)"

# Install Nix

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

. /nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh

# Build and activate nix-darwin configuration

nix run nix-darwin/master#darwin-rebuild -- switch --flake ~/.config/nix

```

Linux (home-manager):

```sh

# Install Nix

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

. ~/.nix-profile/etc/profile.d/nix.sh

# Build and activate home-manager configuration

nix run home-manager/master -- switch --flake ~/.config/nix

```

1. You can now reload your shell and open Sublime Merge

```sh

smerge $DOTFILES_DIR

```

Setup YubiKey for `sudo`

macOS let's you use Touch ID for sudo but dem keyboards be expensive. Maybe you gots a YubiKey, this is how you set it up so you can touch your YubiKey instead of typing your password. The sudo/pam config is taken care of in [flake.nix](.config/nix/flake.nix).

```sh

mkdir ~/.config/Yubico

pamu2fcfg > ~/.config/Yubico/u2f_keys

```

Add a second key if you like

```sh

pamu2fcfg -n >> ~/.config/Yubico/u2f_keys

```

Setup (from scratch)

Follow these steps to recreate the setup for this repo from scratch.

1. Create repository to store dotfiles

```sh

DOTFILES_DIR=$HOME/git/dotfiles

git init --bare $DOTFILES_DIR

```

1. Change worktree to home directory

```sh

cd $DOTFILES_DIR

git config --unset core.bare

git config core.worktree $HOME

```

1. Ignore all files except .gitignore ([Sublime merge doesn't support status.showUntrackedFiles=no](https://github.com/sublimehq/sublime_merge/issues/1544))

```sh

cd $HOME

echo "/*" >> .gitignore

echo "!.gitignore" >> .gitignore

```

1. Add alias to .zshrc

```sh

echo "alias dotfiles='git --git-dir=$HOME/git/dotfiles/'" >> $HOME/.zshrc

```

1. You can now start [tracking files](#usage)

Inspired by

• [StreakyCobra's comment on Hacker News for idea to avoid symlinks with bare repo](https://news.ycombinator.com/item?id=11071754)
• [zwyx's blog post for Sublime Merge integration](https://zwyx.dev/blog/your-dotfiles-in-a-git-repo)
• [Using a YubiKey (or other security key) for sudo via pam](https://neilzone.co.uk/2022/11/using-a-yubikey-or-other-security-key-for-sudo-via-pam/)