diff --git a/README.md b/README.md
index 48652b8..ec07fce 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,26 @@
-# Espanso
\ No newline at end of file
+# espanso
+
+Cross-platform Text Expander written in Rust
+
+![example](/images/example.gif)
+
+### Features
+
+* Works on Windows, MacOS and Linux
+* Works with almost any program
+* Works with Emojis
+* File based configuration
+
+### What is a Text Expander?
+
+
+
+## Getting started
+
+### Installation
+
+
+
+### License
+
+espanso is licensed under the [GPL-3.0 license](/LICENSE).
\ No newline at end of file
diff --git a/images/example.gif b/images/example.gif
new file mode 100644
index 0000000..cb08403
Binary files /dev/null and b/images/example.gif differ