megalithic / dotfiles

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

Installation

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

curl -fsSL https://raw.githubusercontent.com/megalithic/dotfiles/master/bin/_dotup | /usr/bin/env zsh

The install script will install things and symlink the appropriate files in ~/.dotfiles to your home directory (~). Everything is configured and tweaked within ~/.dotfiles, though. All files and folders ending in .symlink get -- you guessed it -- symlinked. For example: ~/.dotfiles/zsh/zshrc.symlink gets symlinked to ~/.zshrc.

This also sets up things like homebrew if you're on a mac, and even allows for a private repo setup. Please note, this dotfiles repo supports multiple platforms, but has really only been extensively used and tested on MacOS.

I highly recommend you dig into the scripts and configs to see what all is going on (because it does a lot that I'm not describing here) before you install a stranger's shell scripts all willy-nilly, throwing caution to the wind. 🤣

Things

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

• homebrew
  • see ~/.dotfiles/homebrew/Brewfile for all that gets installed
• hammerspoon
• karabiner-elements
  • see ~/.dotfiles/keyboard for macOS specific config things
  • see my QMK dz60 config for my custom keyboard setup
• tmux
  • additional tmux statusbar binaries available (see tmux-* files in ~/.dotfiles/bin).
  • see also my DND tmux plugin
• jetbrains mono
  • patched via nerd-fonts
• kitty
• nova
• neovim
• zsh
  • custom prompt (mimicking pure), using gitstatus for fast git-specific vcs status.
• weechat

Stuff

The file hierarchy:

• bin/: Anything in bin/ will get added to your $PATH and be made available everywhere.
• topic/*.symlink: Any files ending in *.symlink get symlinked into your $HOME. This is so you can keep all of those versioned in your dotfiles but still keep those autoloaded files in your home directory. These get symlinked when you run bin/_dotup, or you can explicitly run bin/_symlinks.
• topic/<platform>.sh: Platform-specific installers to handle additional things that you may need to happen for that topic. all | macos | linux | freebsd | windows

Privates

Use ~/.localrc as your location for sensitive information. Optionally, you can let bin/_dotup handle the cloning of your private repo to ~/.dotfiles/private, which will execute an install script, assuming it's located at ~/.dotfiles/private/install.sh.

Props

• So many esteemed individuals in the community have, in some way, left their mark on my own dotfilery:

  • Zach Holman
  • Wynn Netherland
  • Evan Travers
  • Dorian Karter
  • Phil Ridlen

Refs

• A wealth of handy scripts/bins: https://github.com/salman-abedin/alfred