diff --git a/README.md b/README.md
index e06adab..a80a3e1 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,48 @@
-# VersionEye plug-in for the Kobalt  [Kobalt](http://beust.com/kobalt/home/index.html)
+# VersionEye plug-in for [Kobalt](http://beust.com/kobalt/home/index.html)
 
 [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause) [![Build Status](https://travis-ci.org/ethauvin/kobalt-versioneye.svg?branch=master)](https://travis-ci.org/ethauvin/kobalt-versioneye) [![Download](https://api.bintray.com/packages/ethauvin/maven/kobalt-versioneye/images/download.svg) ](https://bintray.com/ethauvin/maven/kobalt-versioneye/_latestVersion)
 
-[![VersionEye Dependencies](src/site/images/VersionEyeLogo.png)](https://www.versioneye.com)
+[![VersionEye Logo](src/site/images/VersionEyeLogo.png)](https://www.versioneye.com)
+
+The plug-in will create and update projects on [VersionEye](https://www.versioneye.com/), a service that notifies you about out-dated dependencies, security vulnerabilities and license violations.
+
+To use the plug-in include the following in `Build.kt` file:
+
+```kotlin
+import net.thauvin.erik.kobalt.plugin.versioneye.*
+
+val pl = plugins("net.thauvin.erik:kobalt-versioneye:0.4.0-beta")
+
+val p = project {
+
+    name = "example"
+    group = "com.example"
+    artifactId = name
+    version = "0.1"
+    
+    versionEye {
+    }
+```
+To create or update your project on VersionEye, you will need an API key. If you are [signed up](https://www.versioneye.com/signup), you can find your API Key [here](https://www.versioneye.com/settings/api):
+
+[![VersionEye API Key](src/site/images/VersionEyeApiKey.png)](https://www.versioneye.com/settings/api)
+
+To create your project on VersionEye simply use your API Key as follows
+
+```bash
+./kobaltw -Dversioneye.ApiKey=YOUR_API_KEY_HERE versionEye
+```
+
+This will instruct the plug-in to create and update your project on VersionEye. Your API Key will automatically be saved in the`local.properties` file.
+
+Upon running the above command the plug-in will output something like:
+
+[![Example Report](src/site/images/ExampleReport.png)]
+
+The repot is based on the Traffic Light concept:
+
+1. Green items are clear.
+2. Yellow items may require some attention.
+3. Red items will cause the build to fail.
+
+By default the plug-in is configured to only fail on known security vulnerability.
diff --git a/src/site/images/ExampleReport.png b/src/site/images/ExampleReport.png
new file mode 100644
index 0000000..2e3d5d0
Binary files /dev/null and b/src/site/images/ExampleReport.png differ
diff --git a/src/site/images/VersionEyeApiKey.png b/src/site/images/VersionEyeApiKey.png
index 3e0b967..83e048c 100644
Binary files a/src/site/images/VersionEyeApiKey.png and b/src/site/images/VersionEyeApiKey.png differ
diff --git a/src/site/images/VersionEyeLogo.png b/src/site/images/VersionEyeLogo.png
index fe94c44..f2b0d65 100644
Binary files a/src/site/images/VersionEyeLogo.png and b/src/site/images/VersionEyeLogo.png differ