diff --git a/README.md b/README.md
index d037838..2558b88 100644
--- a/README.md
+++ b/README.md
@@ -2,4 +2,32 @@
 
 [Heroicons](https://github.com/tailwindlabs/heroicons) are "a set of free MIT-licensed high-quality SVG icons for you to use in your web projects". This package gives you Elixir functions to drop Heroicons into your HTML, styled with arbitrary classes.
 
-Heroicons are designed by [Steve Schoger](https://twitter.com/steveschoger)
\ No newline at end of file
+Heroicons are designed by [Steve Schoger](https://twitter.com/steveschoger)
+
+## Installation
+
+Add Heroicons to your `mix.exs`:
+
+defp deps do
+  [
+    {:heroicons, "~> 0.1.0"}
+  ]
+end
+
+After that, run `mix deps.get`.
+
+## Usage
+
+The icons are in `Heroicons.Solid` and `Heroicons.Outline`. You can get a heroicon by name
+
+```eex
+<%= Heroicons.Solid.cake() %>
+```
+
+and style it with some classes
+
+```eex
+<%= Heroicons.Solid.cake(class: "h-6 w-6 text-gray-500") %>
+```
+
+For a full list of icons see [the docs](https://hexdocs.pm/heroicons/api-reference.html) or [heroicons.com](https://heroicons.com/).