README.md in heroicon-0.3.0 vs README.md in heroicon-0.4.0

@@ -1,33 +1,36 @@
 # Heroicon
+
 [![Build Status](https://github.com/bharget/heroicon/workflows/CI/badge.svg)](https://github.com/bharget/heroicon/actions)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
 
 Ruby on Rails view helpers for the beautiful hand-crafted SVG icons, Heroicons.
 
- Used in production at [Morning Brew ☕](https://www.morningbrew.com/?utm_source=bharget_github)
+Used in production at [Morning Brew ☕](https://www.morningbrew.com/?utm_source=bharget_github)
 
-
 This gem has no official affiliation with Tailwind CSS or the Heroicon team (yet!). Check out their sites:
 
 - [Tailwind CSS](https://tailwindcss.com/?utm_source=bharget_github)
 - [Tailwind UI](https://tailwindui.com/?utm_source=bharget_github)
 - [Heroicons](https://heroicons.com/?utm_source=bharget_github)
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
 gem "heroicon"
 ```
 
 And then execute:
+
 ```bash
 $ bundle
 ```
 
 Run the installer
+
 ```bash
 $ rails g heroicon:install
 ```
 
 ## Usage
@@ -36,11 +39,11 @@
 
 ```rb
 <%= heroicon "search" %>
 ```
 
-Heroicon comes with two variants, `:outline` and `:solid`. By default it uses the variant provided in the configuration file that was generated during installation. To overwrite this in the view, use
+Heroicon comes with two variants, `:outline` and `:solid`. The default variant is `:solid`. This can be changed in `config/initializers/heroicon.rb`, which is generated during installation (See [Configuration](#configuration)). To overwrite this in the view, use
 
 ```rb
 <%= heroicon "search", variant: :outline %>
 ```
 
@@ -48,12 +51,40 @@
 
 ```rb
 <%= heroicon "search", options: { class: "text-primary-500" } %>
 ```
 
-Heroicon currently supports icons up to [`Version 0.4.2`](https://github.com/tailwindlabs/heroicons/releases/tag/v0.4.2). If there is a icon that is missing, feel free to contribute by following our contributing guide below.
+Heroicon currently supports icons up to [`Version 1.0.1`](https://github.com/tailwindlabs/heroicons/releases/tag/v1.0.1). If there is a icon that is missing, feel free to contribute by following our contributing guide below.
 
+# Configuration
+
+After running `rails g heroicon:install` in the installation step, a configuration file will be created at `config/initializers/heroicon.rb`.
+
+Currently there are two configuration options:
+
+- `variant`: The default variant to use if no variant is specified in the view.
+  - You can set this to either `:outline` or `:solid`. Defaults to `:solid`.
+- `default_class`: A default class that gets applied to every icon.
+  - This accepts either a String to apply to every icon, or a Hash, which applies the class based on the variant of the icon (see the example below).
+  - You can disable this on a per-icon basis by passing `disable_default_class: true` in the options hash within the view.
+  - _Note: If you use the `default_class` option with PurgeCSS (or something similar), make sure you add the classes you want to use to the generated CSS file. For PurgeCSS, you may want to add `config/intializers/heroicon.rb` to the list of purged paths._
+
+An example configuration looks like this:
+
+```ruby
+Heroicon.configure do |config|
+  config.variant = :solid
+  config.default_class = {solid: "h-5 w-5", outline: "h-6 w-6"}
+end
+```
+
+Disabling the default class in the view:
+
+```rb
+<%= heroicon "search", options: { class: "custom-class" disable_default_class: true } %>
+```
+
 ## Contributing
 
 Anyone is encouraged to help improve this project. Here are a few ways you can help:
 
 - [Report bugs](https://github.com/bharget/heroicon/issues)
@@ -69,6 +100,7 @@
 bundle install
 bundle exec rake test
 ```
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).