diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..3d35b7e
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,11 @@
+# chat
+
+simple example of:
+
+- simple chat server over websockets (nothing novel here)
+- embedded static assets
+
+installation:
+
+    $ go get mcquay.me/chat
+    $ go get mcquay.me/chat/cmd/chatd