Skip to content

sunpech/dotfiles

Repository files navigation

Sunpech's dotfiles

My dotfiles for macOS. This will help you get started setting up a fresh new Mac.

I use GNU stow to manage symlinks for configurations.

Requirements

You need to run z shell (zsh), which is default since macOS Catalina, in 2019.

You'll need to have homebrew installed.

Then you'll need git and stow to install this dotfiles repository.

brew install git stow

Installation

Clone repo (with submodules)

git clone --recurse-submodules git@github.com:sunpech/dotfiles.git

mv dotfiles ~/.dotfiles

cd ~/.dotfiles

Run stow

Use stow to create symlinks for config files.

I disagree with running stow . at the top of the project directory to symlink everything. I think it's better to organize by directory where it's more modular, which is the approach of this repo.

stow zsh ohmyzsh alacritty powerlevel10k nvim vim git wezterm

After running stow above, you should be setup with your dotfiles. You may want to install extras, or even update some submodules-- see sections below.

Terminals

Z shell (zsh)

I use ohmyz.sh (Also see: ohmyzsh Github) and powerlevel10k theme.

I no longer use bash, or Fish Shell with oh-my-fish.

Submodules

There are 2 submodules in this project:

  1. ohmyzsh
  2. alacritty-theme

Be sure to read this. In short, run:

git submodule update

Other commands:

f you already cloned the repository without submodules, you can manually initialize and update them:

git submodule update --init --recursive

After pulling changes to the main repository, you may also need to pull updates for submodules if they have changed. You can use the following command:

git submodule update --remote --merge

Note: The ohmyzsh github has the default location at ~/.oh-my-zsh. I believe the old project was oh-my-zsh (under robbyrussell), before it got moved to ohmyzsh. I prefer ~/.ohmyzsh to keep the naming structure.

Apps

Apps paths used in dotfiles

You'll need to have these installed.

Homebrew Installs

These are some other important homebrew packages.

Neovim related

brew install neovim fd rg ast-grep lazygit

Plugin and theme related

brew install zsh-autosuggestions zsh-syntax-highlighting powerlevel10k font-meslo-lg-nerd-font

Various packages

brew install node openssl rbenv ruby-build wget vim tig rename ssh-copy-id rename toilet tree glances go hugo fastfetch yt-dlp fzf zoxide eza

Wezterm

brew install --cask wezterm

Recommended Apps

I also have a more up to date repo, Best Software List.

Misc

You may want to:

  1. Change your computer’s name or local hostname on Mac
  2. Disable Apple Photos from auto-launching when plugging in sdcard . Run command below.
defaults -currentHost write com.apple.ImageCapture disableHotPlug -bool YES

Other set up links: