Dotfiles

This is a collection of scripts for setting up my personal development environment. It's meant to get a new environment completely configured as fast as possible on a clean install of macOS.

After running through the installation scripts and instructions, you'll have an environment configured with the following tools.

• Homebrew: The de facto package manager for macOS.
• Git: Everyone's favorite distributed version control system.
• Neovim: The world's best text editor. My Neovim configuration includes AstroNvim, a "distribution", as well as a ton of customization.

In addition, these dotfiles install a ton of small, useful command-line utilities and system applications, which can be viewed in the Brewfile.

Prerequisites

Before anything else, install any pending system updates.

softwareupdate -ia

Then, install the Xcode's CLI tools and accept the license.

xcode-select --install
sudo xcodebuild -license accept

Dotfiles

First, clone this repo.

git clone https://github.com/LandonSchropp/dotfiles.git $HOME/.dotfiles

Next, you'll want to run each of the following scripts in-order. Over the years, I've found that something usually breaks every year or two, so it's best to run them individually and debug anything that pops up.

~/.dotfiles/bin/set-up-homebrew      # Install Homebrew and its packages
~/.dotfiles/bin/set-up-zshell        # Install Zsh's framework and plugins
~/.dotfiles/bin/set-up-rcup          # Link dotfiles using rcm
~/.dotfiles/bin/set-up-bat           # Configure bat (cat replacement)
~/.dotfiles/bin/set-up-fzf           # Install fzf's Git integration
~/.dotfiles/bin/set-up-mise-en-place # Install the tools mise manages
~/.dotfiles/bin/set-up-launchd       # Set up launchd services
~/.dotfiles/bin/set-up-macos         # Configure System Settings
~/.dotfiles/bin/set-up-screenshots   # Configure where screenshots are saved
~/.dotfiles/bin/set-up-icloud        # Set up iCloud Drive
~/.dotfiles/bin/set-up-folder-icons  # Give folders custom icons
~/.dotfiles/bin/set-up-finder        # Set up the Finder sidebar and hide unused folders
~/.dotfiles/bin/set-up-dock          # Lay out the Dock
~/.dotfiles/bin/set-up-neovim        # Install and configure Neovim
~/.dotfiles/bin/set-up-claude-code   # Set up Claude Code's skills and integrations
~/.dotfiles/bin/set-up-herdr         # Install and configure Herdr
~/.dotfiles/bin/set-up-hunk          # Install Hunk's extensions
~/.dotfiles/bin/set-up-steam         # Launch Steam games without the Steam window

Git

In order to connect with GitHub, you'll need to generate an SSH key. Follow the instructions on GitHub.

Then authenticate the GitHub CLI, which the Git skills depend on.

gh auth login

On a work machine, set the email address for the repositories in ~/Development/babylist. It isn't committed to this repository.

git config --file ~/.config/git/babylist user.email <work email address>

Utilities

Beyond the setup scripts, this repository includes a handful of small, purpose-built utilities. These are too involved for a single script, but not substantial enough to warrant their own repository. These live in local/share/<name> and are exposed as commands on PATH via local/bin.

Window Manager

The window manager arranges windows into configurable per-workspace layouts, switches FlashSpace profiles based on the connected display, and toggles the focused window between fullscreen and its arranged layout. It's wired into Yabai, FlashSpace, and Karabiner and does not need to be run by hand.

stamp-screenshots

stamp-screenshots points the images in ~/Screenshots at Shottr, so opening one from Finder opens it for editing. macOS binds applications to file types rather than to folders, so the binding is written per file as a com.apple.LaunchServices.OpenWith extended attribute. Images outside that folder, and images whose handler I've already set by hand, are left alone.

update

The update utilities keep my machines current and in sync. They include the following:

• sync-repositories: Syncs the default branch of my active development repositories via git-town.
• sync-dictionaries: Merges the local, Neovim, and iCloud spelling dictionaries.
• back-up-preferences / restore-preferences: Backs up and restores a subset of app preferences to and from iCloud Drive. The list of apps is configured in config/preferences/apps.json. Run restore-preferences when setting up a new machine.
• daily-update: Runs the quick updates — the two syncs above, the tldr cache, and any missing mise tools.
• weekly-update: Upgrades the things that drift — Homebrew packages, mise tools, and Oh My Zsh — then reclaims the disk they leave behind.