diff --git a/README.md b/README.md
new file mode 100644
index 0000000..858f9ef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Portfolio
+
+`gulp serve`
+
+Generate thumbnails: (TODO: gulpify this)
+
+```bash
+convert -define jpeg:size=200x200 assets/image/*  -thumbnail 100x100^ -gravity center -extent 100x100  -set filename:f 'assets/thumb/%t.%e' +adjoin '%[filename:f]'
+```
+
+# TODO
+
+- minify D3.js with selective components