diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eed189f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# spoodle
+
+a vlang parser in zig
+
+## why
+
+because i can
+
+## how
+
+```
+git clone https://gitdab.com/luna/spoodle.git
+cd spoodle
+zig build install --prefix ~/.local/
+```