diff --git a/README.md b/README.md
new file mode 100644
index 0000000..10ac52b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,179 @@
+# Bubble-Picker
+
+[]()
+[](https://jitpack.io/#igalata/Bubble-Picker)
+
+
+
+[Live DEMO on appetize.io](https://appetize.io/app/eem5172h1pvn1wzxf8uq35xqbg?device=nexus5&scale=75&orientation=portrait&osVersion=7.0)
+
+Check this [project on dribbble](https://dribbble.com/shots/3349372-Bubble-Picker-Open-Source-Component)
+
+Read how we did it [on Medium](https://medium.com/@igalata13/how-to-create-a-bubble-selection-animation-on-android-627044da4854#.ajonc010b)
+
+
+
+##Requirements
+- Android SDK 16+
+
+##Usage
+
+Add to your root build.gradle:
+```Groovy
+allprojects {
+ repositories {
+ ...
+ maven { url "https://jitpack.io" }
+ }
+}
+```
+
+Add the dependency:
+```Groovy
+dependencies {
+ compile 'com.github.igalata:Bubble-Picker:v0.1.1'
+}
+```
+
+## How to use this library
+
+Add `BubblePicker` to your xml layout
+
+```xml
+
+
+
+
+
+
+```
+
+Override onResume() and onPause() methods to call the same methods from the `BubblePicker`
+
+Kotlin
+```kotlin
+override fun onResume() {
+ super.onResume()
+ picker.onResume()
+}
+
+override fun onPause() {
+ super.onPause()
+ picker.onPause()
+}
+```
+
+Java
+```java
+@Override
+protected void onResume() {
+ super.onResume();
+ picker.onResume();
+}
+
+@Override
+protected void onPause() {
+ super.onPause();
+ picker.onPause();
+}
+```
+
+Pass the `PickerItem` list to the `BubblePicker`
+
+Kotlin
+```kotlin
+val titles = resources.getStringArray(R.array.countries)
+val colors = resources.obtainTypedArray(R.array.colors)
+val images = resources.obtainTypedArray(R.array.images)
+
+picker.items = ArrayList()
+
+titles.forEachIndexed { i, country ->
+ picker.items?.add(PickerItem(country,
+ gradient = BubbleGradient(colors.getColor((i * 2) % 8, 0), colors.getColor((i * 2) % 8 + 1, 0),
+ BubbleGradient.VERTICAL),
+ typeface = mediumTypeface,
+ textColor = ContextCompat.getColor(this, android.R.color.white),
+ image = ContextCompat.getDrawable(this, images.getResourceId(i, 0))))
+}
+```
+
+Java
+```java
+final String[] titles = getResources().getStringArray(R.array.countries);
+final TypedArray colors = getResources().obtainTypedArray(R.array.colors);
+final TypedArray images = getResources().obtainTypedArray(R.array.images);
+
+picker.setItems(new ArrayList() {{
+ for (int i = 0; i < titles.length; ++i) {
+ add(new PickerItem(titles[i], colors.getColor((i * 2) % 8, 0),
+ ContextCompat.getColor(TestActivity.this, android.R.color.white),
+ ContextCompat.getDrawable(TestActivity.this, images.getResourceId(i, 0))));
+ }
+}});
+```
+
+Specify the `BubblePickerListener` to get notified about events
+
+Kotlin
+```kotlin
+picker.listener = object : BubblePickerListener {
+ override fun onBubbleSelected(item: PickerItem) {
+
+ }
+
+ override fun onBubbleDeselected(item: PickerItem) {
+
+ }
+}
+```
+
+Java
+```java
+picker.setListener(new BubblePickerListener() {
+ @Override
+ public void onBubbleSelected(@NotNull PickerItem item) {
+
+ }
+
+ @Override
+ public void onBubbleDeselected(@NotNull PickerItem item) {
+
+ }
+});
+```
+
+To get all selected items use `picker.selectedItems` variable in Kotlin or `picker.getSelectedItems()` method in Java.
+
+For more usage examples please review the sample app
+
+## License
+
+MIT License
+
+Copyright (c) 2017 Irina Galata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/build.gradle b/build.gradle
index 27a90f5..215309f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,7 +1,7 @@
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
- ext.kotlin_version = '1.0.6'
+ ext.kotlin_version = '1.1.0'
repositories {
jcenter()
}