dotfiles 🌸

Personal Spectrum/Bluefin, macOS, Homebrew, Ansible, and chezmoi setup.

Important

This is my personal setup.

Setup

Spectrum / Bluefin

Start from a fresh Bluefin install:

git clone https://github.com/4evy/dotfiles.git ~/dotfiles
cd ~/dotfiles
sudo bootc switch ghcr.io/4evy/spectrum:latest
systemctl reboot

After rebooting into Spectrum, finish the machine setup:

cd ~/dotfiles
just setup

macOS

git clone https://github.com/4evy/dotfiles.git ~/dotfiles
cd ~/dotfiles
./ansible/bootstrap.sh ansible/playbooks/userland.yml
chezmoi init --source "$PWD/dotfiles"
chezmoi apply --refresh-externals=auto --force

Commands

Run just to see every recipe and alias.

Machine setup

just setup          # first full setup: userland, dotfiles, and host roles
just update         # refresh an already configured machine
just apply          # apply only chezmoi dotfiles
just nix            # install Nix and the repo's Nix profile tools
just doctor setup   # check dependencies needed for setup
just doctor all     # check every known workflow dependency

Spectrum image

just status          # show bootc and image metadata
just install         # switch to the published Spectrum image
just build           # build localhost/spectrum:local without cache
just spectrum-dev    # build the local image using cached layers
just switch          # rebuild and switch/stage the local image
just upgrade         # rebuild the local image and stage a bootc upgrade
just reboot          # reboot through systemd
just spectrum-lint   # validate the image build scripts
just spectrum-diff   # compare RPMs in Bluefin and Spectrum

just install, just switch, and just upgrade handle bootc image updates; just update only refreshes userland, dotfiles, and host roles.

Development

just check           # run the full validation suite
just fmt             # format repository files
just check-format    # check formatting without changing files
just watch check     # rerun checks when files change
just smoke           # build and validate the Fedora smoke-test container
just smoke-shell     # open a shell in the smoke-test container

Focused checks:

go test ./...
uv run --locked pytest
uv run spectrum-build check
cd packages/hyper-window-tiling && bun run check

Nix and Ansible

nix flake check
nix run .#ghidra-mcp
sudo nixos-rebuild switch --flake .#lenovo-legion

ansible-playbook ansible/playbooks/host.yml
ansible-playbook ansible/playbooks/site.yml

License

LICENSE