diff --git a/README.md b/README.md
index 97b08b1..a5f5fef 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
-# tidal-vis
\ No newline at end of file
+# tidal-vis
+
+Tidal is a domain specific language for live coding pattern. This package allows colour patterns to be rendered as PDF or SVG files. http://tidalcycles.org
+
+## Example
+
+```
+density 16 $ every 2 rev $ every 3 (superimpose (iter 4)) $ rev "[black blue darkblue, grey lightblue]"
+```
+![0](https://i.imgur.com/MPbpH0n.jpg)
+
+## Tutorial
+
+[`tidal-vis` installation tutorial](http://blog.kindohm.com/2016/09/02/tidal-vis) by [Kindohm](http://github.com/kindohm)
+
+## Hackage
+
+https://hackage.haskell.org/package/tidal-vis