diff --git a/README.md b/README.md
index 0bd9036..ffa340d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
-# vscode-tailwindcss
+# Tailwind IntelliSense
 
-<img src="https://github.com/bradlc/vscode-tailwindcss/blob/master/src/img/html.gif" alt="HTML autocompletion" width="600">
+> Autocompletion for Tailwind CSS utilities
+
+## HTML
+
+<img src="https://github.com/bradlc/vscode-tailwindcss/blob/master/src/img/html.gif" alt="HTML autocompletion" width="750">
+
+Hover over a class name to preview the CSS:
+
+<img src="https://github.com/bradlc/vscode-tailwindcss/blob/master/src/img/html-hover.gif" alt="HTML hover preview" width="750">
+
+## CSS
+
+In CSS files you get autocompletions when using `@apply` and the `config()` helper.
+
+<img src="https://github.com/bradlc/vscode-tailwindcss/blob/master/src/img/css.gif" alt="CSS autocompletion" width="750">
diff --git a/src/img/css.gif b/src/img/css.gif
new file mode 100644
index 0000000..7e28857
Binary files /dev/null and b/src/img/css.gif differ
diff --git a/src/img/html-hover.gif b/src/img/html-hover.gif
new file mode 100644
index 0000000..94540b8
Binary files /dev/null and b/src/img/html-hover.gif differ