diff --git a/filetreelist/README.md b/filetreelist/README.md
new file mode 100644
index 00000000..627aebd7
--- /dev/null
+++ b/filetreelist/README.md
@@ -0,0 +1,9 @@
+# filetreelist
+
+This crate is designed as part of the [gitui](http://gitui.org) project.
+
+`filetreelist` provides a very common functionality of `gitui`: lists of files visualized as a tree. It allows efficient iteration of only the visual (non collapsed) elements and change the tree state correctly given well defined inputs like `Up`/`Down`/`Collapse`.
+
+It is the main driver behind the file tree feature:
+
+![demo](demo.gif)
\ No newline at end of file
diff --git a/filetreelist/demo.gif b/filetreelist/demo.gif
new file mode 100644
index 00000000..f14be403
Binary files /dev/null and b/filetreelist/demo.gif differ