diff --git a/README.md b/README.md
new file mode 100644
index 0000000..969a0b1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# dotFiles
+Minimal Dark theme for sway including mouse config, GTK theme, kanshi example config, waybar config and custom launcher and power menu using rofi
+
+Theme is based on https://github.com/enkia/tokyo-night-vscode-theme and created by modifying https://github.com/rtlewis88/rtl88-Themes/tree/material-black-COLORS
+If certain colours aren't to your liking, you can `` grep -rl "old_string" . | xargs sed -i 's/old_string/new_string/g' `` to replace specific colour values
+
+Recommended Icon scheme: https://github.com/numixproject/numix-icon-theme
+
+Theme can be installed using lxappearance and/or gnome-tweaks