megalithic / dotfiles

   ┌┬┐┌─┐┌─┐┌─┐┬  ┬┌┬┐┬ ┬┬┌─┐
   │││├┤ │ ┬├─┤│  │ │ ├─┤││   :: bits & bobs, dots & things.
   ┴ ┴└─┘└─┘┴ ┴┴─┘┴ ┴ ┴ ┴┴└─┘
   @megalithic 🗿

🚀 Installation

If you want to kick the tires, you can simply:

git clone https://github.com/megalithic/dotfiles.git ~/.dotfiles && cd ~/.dotfiles && make install

If you want to update an existing install:

make -C ~/.dotfiles up

For platform specific installs:

cd ~/.dotfiles && make macos # or, `linux`
# or, for easier use:
make -C ~/.dotfiles macos

Get some help:

cd ~/.dotfiles && make help
# or, for easier use:
make -C ~/.dotfiles help

NOTE: to execute a make command from anywhere; specifically for your dotfiles: make -C ~/.dotfiles <GOAL>

This dotfiles repo is managed by dotbot; not near as over-the-top configurable as Ansible, but way more advanced than just GNU Stow.

I have tried to be platform agnostic, but the majority of scripts that run here are for MacOS (specifically MacOS Big Sur, non-M1, at the time of this commit -- I'll update here when we move to ARM), with a handful of Debian/Ubuntu Linux specific platform scripts and provisions. This means that certain tools/binaries I rely on may or may not install/configure on Linux. Though, I have tested it reasonably well on Ubuntu-based Linode and DigitalOcean instances.

🐉 Thar be dragons..

I am pushing updates constantly, so there are NO guarantees of stability with my config!

⚠️ I highly recommend you dig into the scripts and configs to see what all is going on (because it does a lot more than what I'm describing in this README) before you -- all willy-nilly, throw caution to the wind -- install a stranger's shell scripts. 🤣

✨ Accoutrements

A few of the must-have tools I roll with:

• kitty
• tmux
• neovim
• zsh
• weechat
• asdf
• homebrew
• megaforest for all the colours/themes
• jetbrains mono font (nerd-fonts patched)
• hammerspoon
• karabiner-elements (atreus62 qmk/leeloo)