diff --git a/README.md b/README.md
new file mode 100644
index 0000000..025a66d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# apr's dotfiles
+
+hi! just a collection of dotfiles, and a simple script to symlink them all into your `.config` 
+directory (or whatever $XDG_CONFIG_HOME happens to be set to). if a config folder already exists 
+it will simply move it to `.config/folder_name.apr_bak`.