diff --git a/README b/README
deleted file mode 100644
index bd00b11..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-lux - a simple library for creating real-time graphical apps
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..023bcb8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# lux - a simple library for creating real-time graphical apps
+
+[Docs](http://docs.racket-lang.org/lux/index.html)
+
+[Examples](https://github.com/jeapostrophe/lux/tree/master/examples)
+
+Installation: ```raco pkg install lux```