diff --git a/README.md b/README.md
index 9ea824d..9e769ca 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 Android library to create complex multi-state animations.
 
+![Demo animation](docs/images/demo1.gif)
+
 ## Overview
 
 A class that allows for complex multi-state animations using Android's
@@ -21,9 +23,9 @@ specified state to the state where the transition is defined.
 
 ### Example JSON animation definition
 
-The following example is annotated with javascript-style comments. Note that
+For illustrative purposes, the following example is annotated with javascript-style comments. However,
 because the Android JSON parser is used in this project,
-**comments in JSON files are not supported**!
+**comments in JSON resource files are not supported**!
 
 ```javascript
 
diff --git a/docs/images/demo_1.gif b/docs/images/demo_1.gif
new file mode 100755
index 0000000..12bf2b4
Binary files /dev/null and b/docs/images/demo_1.gif differ