diff --git a/Demo/WhisperDemo/WhisperDemo.xcworkspace/xcuserdata/RamonGilabert.xcuserdatad/UserInterfaceState.xcuserstate b/Demo/WhisperDemo/WhisperDemo.xcworkspace/xcuserdata/RamonGilabert.xcuserdatad/UserInterfaceState.xcuserstate
index 8d6b5c3..d24ff20 100644
Binary files a/Demo/WhisperDemo/WhisperDemo.xcworkspace/xcuserdata/RamonGilabert.xcuserdatad/UserInterfaceState.xcuserstate and b/Demo/WhisperDemo/WhisperDemo.xcworkspace/xcuserdata/RamonGilabert.xcuserdatad/UserInterfaceState.xcuserstate differ
diff --git a/README.md b/README.md
index 0c209cc..a0dd2f7 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,43 @@
-# Whisper :dash:
+# Whisper :leaves:
 
 [![Version](https://img.shields.io/cocoapods/v/Whisper.svg?style=flat)](http://cocoadocs.org/docsets/Whisper)
 [![License](https://img.shields.io/cocoapods/l/Whisper.svg?style=flat)](http://cocoadocs.org/docsets/Whisper)
 [![Platform](https://img.shields.io/cocoapods/p/Whisper.svg?style=flat)](http://cocoadocs.org/docsets/Whisper)
 
+## Description
+
+Break the silence of your UI, whispering or shouting at it. **Whisper** is a component that will make the task of display messages and in-app notifications simple. It has two different views inside.
+
+#### Whispers
+
+![Whisper](https://github.com/hyperoslo/Whisper/blob/feature/README/Resources/permanent-whisper.png)
+
+Display a short message at the bottom of the navigation bar, this can be anything, from a "Great Job!" to an error message. It can have images or even a loader.
+
+#### Shouts
+
+![In-App](https://github.com/hyperoslo/Whisper/blob/feature/README/Resources/in-app-notification.png)
+
+Fully customizable, from colors to fonts. Shouts have an optional action that will be called if the user taps on it. Finally, if you want to set how long the Shout should be displayed, you have a duration property.
+
+There is no need to think about scroll view insets anymore, this will be handled automatically by Whisper. As and added bonus, when transitioning from one view controller to another, the next controllers offset will be adjusted like you would except. It just works!
+
 ## Usage
 
+The usage of the component is so simple, you just create a message in the case of Whisper, or an announcement in the case of a Shout, it's done like this:
+
+##### For a Whisper:
+
 ```swift
-<API>
+let message = Message(title: "Enter your message here.", color: UIColor.redColor())
+Whisper(message, to: navigationController, action: .Present)
+```
+
+##### For a Shout:
+
+```swift
+let announcement = Announcement(title: "Your title", subtitle: "Your subtitle", image: UIImage(named: "avatar"))
+Shout(announcement, to: self)
 ```
 
 ## Installation
@@ -19,6 +49,16 @@ it, simply add the following line to your Podfile:
 pod 'Whisper'
 ```
 
+## Roadmap
+
+In the future the idea is to keep improving and add some features:
+
+- Improve the offset detection and animation.
+- Add more UI related components into Whisper.
+- More customization points and more sizes for each whisper.
+- Custom actions inside Whispers and Shouts.
+- We are open to new and awesome ideas, contribute if you like! :)
+
 ## Author
 
 Hyper Interaktiv AS, ios@hyper.no
diff --git a/Resources/in-app-notification.png b/Resources/in-app-notification.png
new file mode 100644
index 0000000..3462ad0
Binary files /dev/null and b/Resources/in-app-notification.png differ
diff --git a/Resources/permanent-whisper.png b/Resources/permanent-whisper.png
new file mode 100644
index 0000000..793e135
Binary files /dev/null and b/Resources/permanent-whisper.png differ