diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..363552f
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,8 @@
+# nat/ui
+the desktop shell for its computer.
+
+liable to be ported to a different language around 3 more times.
+
+it wrote python bindings for libastal because it hates javascript and lgi documentation is questionable
+
+it should probably submit a pull to github:aylur/astal to get its python bindings added