These are my dotfiles. Take anything you want, but at your own risk.
It mainly targets macOS systems, but it works on at least Ubuntu as well.
- Minimal efforts to install everything, using a Makefile
- Mostly based around Homebrew, Caskroom and Node.js, latest Bash + GNU Utils
- Great Window management (using Hammerspoon)
- 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 using a GitHub Action
- Homebrew (packages: Brewfile)
- homebrew-cask (packages: Caskfile)
- Node.js + npm LTS (packages: npmfile)
- Latest Git, Bash 4, Python 3, GNU coreutils, curl, Ruby
- Hammerspoon (config: keybindings & window management)
- Mackup (sync application settings)
$EDITOR(and Git editor) is GNU nano
On a sparkling fresh installation of macOS:
sudo softwareupdate -i -a xcode-select --install
The Xcode Command Line Tools includes
make (not available on stock macOS). Now there are two options:
- Install this repo with
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
- Alternatively, clone manually into the desired location:
git clone https://github.com/webpro/dotfiles.git ~/.dotfiles
cd ~/.dotfiles make
The installation process in the Makefile is tested on every push and every week in this GitHub Action.
dotfiles dock(set Dock items)
dotfiles macos(set macOS defaults)
- Log in to Dropbox (and wait until synced)
ln -s ~/.config/mackup/.mackup.cfg ~(until #632 is fixed)
$ dotfiles help Usage: dotfiles <command> Commands: clean Clean up caches (brew, npm, gem, rvm) dock Apply macOS Dock settings edit Open dotfiles in IDE (code) and Git GUI (stree) help This help message macos Apply macOS system defaults test Run tests update Update packages and pkg managers (OS, brew, npm, gem)
You can put your custom settings, such as Git credentials in the
system/.custom file which will be sourced from
.bash_profile automatically. This file is in
Alternatively, you can have an additional, personal dotfiles repo at
~/.extra. The runcom
.bash_profile sources all
Many thanks to the dotfiles community.