diff --git a/readme.rst b/readme.rst
new file mode 100644
index 0000000..a126f09
--- /dev/null
+++ b/readme.rst
@@ -0,0 +1,9 @@
+Karax -- Single page applications in Nim
+========================================
+
+Karax is a prototype for developing single page applications in Nim.
+
+To try it out, run::
+
+  nim js example.nim
+  open example.html
diff --git a/todo.rst b/todo.rst
index eb9850c..7ddd5be 100644
--- a/todo.rst
+++ b/todo.rst
@@ -1,4 +1,6 @@
 - Better virtual dom diff'ing algorithm: find longest common subsequence
 - add CSS changes to todo example.nim
 - handle onscroll events
+- introduce a way to test karax applications
+- introduce a way to do AJAX