diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ea1da7b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# my quickshell config 
+
+## what it does
+This quickshell config implements most things needed for a nice desktop experience:
+- A statusbar
+- Notifications (very simple)
+- Wallpaper (switching)
+- Theme match base16 themes applied by tinty
+
+# !(screenshot)[screenshot.png]
+
+# Roadmap
+- add applet for wallpaper and theme switching
+    - maybe built into the bar as popup?
+- Improve notifications to be kept, snoozed etc
+- Improve style since the current one is quite boring
+
+
diff --git a/screenshot.png b/screenshot.png
new file mode 100644
index 0000000..f856bad
Binary files /dev/null and b/screenshot.png differ