diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..5a8266c
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,11 @@
+# yay
+
+simple go library and sample programs for rendering a little text-based
+animation.
+
+## installation
+
+    $ go get mcquay.me/yay/...
+    $ yay
+    $ dance
+    $ shrug