diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2224a2f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+custom event system for js.
+
+unlike the regular event system, this doesn't "attach" events to anything; rather, an event listener is simply a function that gets called when an event is triggered.
+
+currently, this is synchronous; triggering an event will take as long as calling all its listeners.