.files
These are my dotfiles. Take anything you want, but at your own risk.
Mainly targets macOS systems, but works on Ubuntu and Arch Linux as well.
Highlights
- Minimal efforts to install everything, using a Makefile
- Mostly based around Homebrew, Caskroom and Node.js, latest Bash + GNU Utils
- Fast and colored prompt
- Updated macOS defaults
- Well-organized and easy to customize
- The installation and runcom setup is tested weekly on real Ubuntu and macOS machines (Sonoma/14, Sequoia/15, Tahoe/26) using a GitHub Action
- Supports both Apple Silicon (M1) and Intel chips
Packages Overview
- Homebrew (packages: Brewfile)
- homebrew-cask (packages: Caskfile)
- Node.js + npm LTS (packages: npmfile)
- Latest Git, Bash, Python, GNU coreutils, curl, Ruby
- Editors: VS Code and nano (
EDITOR,VISUALand Gitcore.editor)
Installation
On a sparkling fresh installation of macOS:
sudo softwareupdate -i -a
xcode-select --install
The Xcode Command Line Tools includes git and make (not available on stock macOS). Now there are two options:
- Install this repo with
curlavailable:
bash -c "`curl -fsSL https://raw.githubusercontent.com/webpro/dotfiles/master/remote-install.sh`"
This will clone or download this repo to ~/.dotfiles (depending on the availability of git, curl or wget).
- Alternatively, clone manually into the desired location:
git clone https://github.com/webpro/dotfiles.git ~/.dotfiles
- Use the Makefile to install the packages listed above, and symlink runcom and config files (using stow):
cd ~/.dotfiles
make
Running make with the Makefile is idempotent. The installation process in the Makefile is tested on every push and every week in this
GitHub Action. Please file an issue in this repo if there are errors.
Post-Installation
- Set your Git identity:
git config --global user.name "your name"
git config --global user.email "[email protected]"
git config --global github.user "your-github-username"
- Authenticate GitHub CLI:
gh auth login
- Set macOS Dock items and system defaults:
dot dock
dot macos
- Populate this file with anything you need sourced in each shell:
mkdir -p $DOTFILES_DIR/local
touch $DOTFILES_DIR/local/.profile
touch $DOTFILES_DIR/local/.env
The dot command
$ dot help
Usage: dot <command>
Commands:
clean Clean up caches, logs, temporary files, and app leftovers
dock Apply macOS Dock settings
duti Set default apps for file types (UTI)
edit Open dotfiles in IDE (code) and Git GUI (fork)
help This help message
macos Apply macOS system defaults and optional system setup
test Run tests
update Update packages and pkg managers (e.g. Homebrew, npm, gems)
Customize
To customize the dotfiles to your likings, fork it and be the king of your castle!
Credits
Many thanks to the dotfiles community.
