diff --git a/.void.bash_aliases b/.void.bash_aliases
new file mode 100644
index 0000000..bed5c7b
--- /dev/null
+++ b/.void.bash_aliases
@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# import general use aliases
+[[ -r ~/.alias ]] && . ~/.alias
+
+# xbps-install
+alias xin="doas xbps-install -S"
+alias xup="doas xbps-install -Su"
+
+# xbps-query
+alias xq="xbps-query"
+alias xs="xq -Rs"
+alias xqs="xq -S"
+alias xqm="xq -m"
+alias xql="xq -l"
+alias xqq="xql | grep ${1}"
+
+# xbps-remove
+alias xr="doas xbps-remove -R"
+alias xcln="xr -o"
+
+# config edits
+alias cb="vim $HOME/.config/bspwm/bspwmrc"
+alias csx="vim $HOME/.config/sxhkd/sxhkdrc"
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6c8d8d8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# dotfiles
+
+Contains .dotfiles for my debian and void distros.
+Clone and `ln -s` the applicable files to the distro agnotic filenames. e.g.:
+
+`ln -s .void.bashrc .bashrc`
+
+I will add an install script at a later date.