README.md

Dotfiles Repository

Personal .dotfiles for macOS (Apple Silicon) and Manjaro (amd64) running zsh

Warning

This repository is intended for personal use and should be run on a new machine. Do not use it directly without understanding its operations. Running ./install will overwrite existing dotfiles!

Note

Ensure using a login shell.
Feel free to fork it and modify it to suit your needs or open issues/PRs to discuss 😌.

Workflow for macOS (Apple Silicon)

1. Update system

   softwareupdate --install --all

2. Install Command Line Tools

   xcode-select --install

3. Install dotfiles

   All packages listed in macos/Brewfile will be installed.

   git clone https://github.com/xu-minghao317/dotfiles.git ~/.dotfiles --recursive
   cd ~/.dotfiles
   ./install macos

4. Restart your terminal, and you should be good to go! 🎉
   (Ghostty comes pre-installed with JetBrains Mono Nerd Font and Catppuccin theme. For other terminals, manually install a Nerd Font and apply a Catppuccin theme.)

Optional Steps for macOS

1. Enable Touch ID for sudo:

   macOS Sonoma adds support to permanently enable Touch ID for sudo. On Sonoma and above we do:

   sudo cp /etc/pam.d/sudo_local.template /etc/pam.d/sudo_local
   sudo vim /etc/pam.d/sudo_local

   Uncomment the only line there:

   - #auth       sufficient     pam_tid.so
   +  auth       sufficient     pam_tid.so

Workflow for Manjaro (amd64)

1. Update system

   sudo pacman -Syu

2. Install dotfiles

   All packages listed in linux/pacman-packages.txt will be installed.

   git clone https://github.com/xu-minghao317/dotfiles.git ~/.dotfiles --recursive
   cd ~/.dotfiles
   ./install manjaro

3. Restart your terminal, and you should be good to go! 🎉
   (Ghostty comes pre-installed with JetBrains Mono Nerd Font and Catppuccin theme. For other terminals, manually install a Nerd Font and apply a Catppuccin theme.)