diff --git a/README.md b/README.md
index 407631b..2564518 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,37 @@
-## Visit https://backgroundgradients.com/
-
 # backgroundgradients.com
-A Simple website that generates the copy-pastable code of the gradient of your choice in RGB and CSS format
+
+*A simple website that generates the copy-pastable code of the gradient of your choice in RGB and CSS format.*
+
+## Installation
+
+Just head over to [https://backgroundgradients.com/](https://backgroundgradients.com/) to get started.
+
+## Usage
+
+Generate a random two-color gradient by clicking the 🔁 symbol.
+<p align="center">
+  <img width="max" src="images/random-demo.gif">
+</p>
+
+For more tuning, you can choose colors with the color picker:
+<p align="center">
+  <img width="max" src="images/choose-demo.gif">
+</p>
+
+Change the gradient angle via the wheel or the text box:
+<p align="center">
+  <img width="max" src="images/angle-demo.gif">
+</p>
+
+Export your gradients in either CSS or plain RGB:
+<p align="center">
+  <img width="max" src="images/export-demo.gif">
+</p>
+
+## Contributing
+Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
+
+Please make sure to update tests as appropriate.
+
+## License
+[MIT](https://choosealicense.com/licenses/mit/)
\ No newline at end of file
diff --git a/images/angle-demo.gif b/images/angle-demo.gif
new file mode 100644
index 0000000..10360e1
Binary files /dev/null and b/images/angle-demo.gif differ
diff --git a/images/choose-demo.gif b/images/choose-demo.gif
new file mode 100644
index 0000000..788e7ac
Binary files /dev/null and b/images/choose-demo.gif differ
diff --git a/images/export-demo.gif b/images/export-demo.gif
new file mode 100644
index 0000000..ae075bb
Binary files /dev/null and b/images/export-demo.gif differ
diff --git a/images/random-demo.gif b/images/random-demo.gif
new file mode 100644
index 0000000..a34dcfa
Binary files /dev/null and b/images/random-demo.gif differ