diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f33b7c0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# shade_runner
+A shader hotloader for vulkano.
+
+This project is incomplete but working.
+If something isn't implimented yet you will get `Err(ConvertError::Unimplemented)` from `parse(...)`.
+PRs and issues are welcome.
+
+Examples comming very soon.