diff --git a/README b/README
new file mode 100644
index 0000000..6ece9d0
--- /dev/null
+++ b/README
@@ -0,0 +1,26 @@
+sowm
+====
+a simple floating window manager
+
++----+
+|KEYS|
++----+
+Mod+[Enter] -> terminal
+Mod+[d] -> dmenu
+
+Alt+Tab -> cycle windows
+
+Mod+[h,j,k,l] -> move current window
+Mod+Shift+[h,j,k,l] -> resize current window
+Mod+Alt+[h,j,k,l] -> halve current window
+
++--------+
+|CONFIG.H|
++--------+
+BORDER_COLOR -> color of the border 
+BORDER_WIDTH -> width of a border (in px)
+
++----+
+|TODO|
++----+
+change border color depending on focus