dotfiles

macOS only. Tested on Apple Silicon (M-series) with Homebrew.

Table of Contents

• About
  • Requirements
  • Installing
  • Customizing
  • Utilities

About

My macOS dotfiles — bash config, aliases, functions, git settings, and more.

Requirements

• macOS Apple Silicon (M-series)
• Homebrew
• Xcode Command Line Tools: xcode-select --install

Installing

Clone the repo and create the symlinks:

$ git clone git@github.com:ymsaout/dotfiles.git ~/dotfiles
$ cd ~/dotfiles
$ make

For a full setup from scratch (Homebrew packages, Rust, symlinks):

$ cd ~/dotfiles
$ make           # create symlinks
$ make bootstrap # Homebrew + packages + Rust

Or step by step:

$ bin/install.sh base  # Homebrew + packages + bash 5
$ bin/install.sh rust  # Rust

Customizing

Save env vars, tokens, and machine-specific config in a ~/.extra file (not committed). Use .extra.example as a template:

$ cp ~/dotfiles/.extra.example ~/.extra

Git identity is required — set it directly so it works everywhere (terminal, VSCode, CI...):

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

You can also export GITHUB_USER and other tokens in ~/.extra:

export GITHUB_USER="your_github_username"

Utilities

Script	Description
bin/install.sh	Full macOS setup (Homebrew, Rust, dotfiles)
bin/macos-defaults	Apply macOS system preferences. Run once after a fresh install. Usage: COMPUTER_NAME="mymac" TIMEZONE="Europe/Paris" bin/macos-defaults
bin/update-repos	git pull all repos found in $HOME