dotfiles

My dotfiles for Neovim, zsh, tmux, and ghostty on macOS. Managed with GNU Stow.

Installation

1. Install Homebrew:

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

2. Install prerequisites:

brew install git stow

3. Clone the repo:

git clone git@github.com:iamvictorli/dotfiles.git ~/workspace/dotfiles
cd ~/workspace/dotfiles

4. Run the install script:

./install

This requires Homebrew, git, and GNU Stow to already be installed, then stows the packages from stow/, installs everything else from Brewfile, installs the latest LTS Node.js via fnm, and installs trash-cli.

5. (Optional) Cleanup packages not in Brewfile:

brew bundle cleanup --force

Stow individual packages

Stow packages live under stow/.

cd ~/workspace/dotfiles
stow -d stow -t ~ zsh     # Just zsh config
stow -d stow -t ~ nvim    # Just nvim config
stow -d stow -t ~ -D zsh  # Unstow (remove symlinks)

Available packages

Package	Description
zsh	Shell configuration
tmux	Terminal multiplexer
ssh	SSH configuration
nvim	Neovim configuration
ghostty	Ghostty terminal
starship	Starship prompt
lazygit	Lazygit configuration
yazi	Yazi file manager theme
opencode	OpenCode configuration

Terminal

I use Ghostty as my terminal emulator.

• homebrew, package manager for macOS

• fnm, fast and simple node version manager. faster than nvm

• trash-cli, safeguard rm. Version 5 sometimes runs into node issues, stick with version 4 npm install --global trash-cli@v4.0.0.

• starship prompts, minimal customizable prompts

• yazi, terminal file manager

• tmux, terminal multiplexer

• lazygit, simple terminal UI for git commands, requires git to be installed first

• lazydocker, the lazier way to manage docker, requires docker to be installed first

• eza, replacement for ls

• fd, simple, fast and user-friendly alternative to find

• ripgrep, fast regex text searching in directories

• fzf, command line fuzzy finder

• delta, A syntax-highlighting pager for git diff, https://x.com/rauchg/status/1831421759666676165, https://cpojer.net/posts/the-perfect-development-environment#bat-and-delta

Mac Settings

• System preferences > Accessibility > Display > Reduce Motion. Toggle on

• System preferences > Accessibility > Display > Increase contrast. Toggle on

• System preferences > Accessibility > Display > Reduce Transparency. Toggle on

• System preferences > Accessibility > Pointer > Reduce mouse pointer to locate. Toggle on

• System preferences > Accessibility > Pointer > Pointer size. Slider to largest

• Dock > Size. Slider on 20%

• Dock > Magnification. Slider on Small

• Dock > Position on screen. Select Left

• Dock > Minimize windows into application icon. Toggle off

• Dock > Automatically hide and show the Dock. Toggle on

• Dock > Animate opening applications. Toggle on

• Dock > Show indicators for open applications. Toggle on

• Dock > Show recent applications in Dock. Toggle off

• Keyboard > Key Repeat. Fastest. Slider to largest

• Keyboard > Delay until Repeat. Shortest. Slider to largest

• Accessibility > Vision > Display > Pointer > Pointer Size. Largest. Slider to largest

• Desktop & Screen Saver > Wallpaper

Keyboard modifier keys

Apple Internal Keyboard

Custom Mechanical Keyboard

Programs

• Docker Desktop
• IINA, modern media player for MacOS
• Tailscale
• TextSniper
• 1password
• Yaak

Font

• JetBrainsMono Nerd Font

Interesting programs I may or may not pickup

• vimium c vim key bindings for the browser
• helix text editor inspired by neovim and kakoune
• zellij a terminal workspace, alternative to tmux
• mise, better tool management for dev environments
• https://github.com/alexpasmantier/television, similar to fzf, but with more customization?

Interesting Paid Products I may or may not pickup

• TablePlus
• ProxyMan