diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..21f929d
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,48 @@
+# Contributing to Checkable TextView
+We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
+
+- Reporting a bug
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+- Becoming a maintainer
+
+## We Develop with Github
+We use github to host code, to track issues and feature requests, as well as accept pull requests.
+
+## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html), So All Code Changes Happen Through Pull Requests
+Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests:
+
+1. Fork the repo and create your branch from `master`.
+2. If you've added code that should be tested, add tests.
+3. If you've changed APIs, update the documentation.
+4. Ensure the test suite passes.
+5. Make sure your code lints.
+6. Issue that pull request!
+
+## Any contributions you make will be under the MIT Software License
+In short, when you submit code changes, your submissions are understood to be under the same [MIT License](http://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.
+
+## Write bug reports with detail, background, and sample code
+
+**Great Bug Reports** tend to have:
+
+- A quick summary and/or background
+- Steps to reproduce
+ - Be specific!
+ - Give sample code if you can.
+- What you expected would happen
+- What actually happens
+- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
+
+People *love* thorough bug reports. I'm not even kidding.
+
+## Use a Consistent Coding Style
+
+ - Use consistent coding style for uniform coding standard and readibility.
+
+## License
+By contributing, you agree that your contributions will be licensed under its MIT License.
+
+## References
+This document was adapted from the open-source contribution guidelines template [Good-CONTRIBUTING](https://gist.github.com/PurpleBooth/b24679402957c63ec426)
diff --git a/README.md b/README.md
index 93d0b61..84304ef 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,155 @@
-# CheckableTextView
-A simple and flexible Checked TextView or Checkable TextView
+
+
+
CheckableTextView
+
+
+--------------
+
+
+
+Checkable TextView [KOTLIN]
+
+:zap:A simple and flexible Checked TextView or Checkable TextView written in Kotlin:zap:
+
+------------------
+
+
+[](https://jitpack.io/#JDevZone/CheckableTextView)
+[](https://android-arsenal.com/details/1/7770)
+[](https://github.com/JDevZone/CheckableTextView/blob/master/LICENSE)
+
+
+
+
+---------------------------
+### What's New
+
+| Animation | Demo |
+| --- | :---: |
+| New Ripple Like Fill Effect
| 
|
+| Normal (duration = 250 ms)
| 
|
+| Custom Duration (duration = 2000 ms)
| 
|
+
+> Sorry for flicker in slow motion video demo . You know android studio screen recorder sucks sometimes :sweat_smile:
+
+### Custom Interpolators
+> custom interpolator support added
+
+| Interpolator | Demo |
+| --- | :---: |
+| BounceInterpolator with fall down animation
| 
|
+| AnticipateOvershootInterpolator with translate animation
| 
|
+
+
+---------------------------
+### Installation
+
+1. Add it in your root build.gradle at the end of repositories:
+```groovy
+ allprojects {
+ repositories {
+ ...
+ maven { url 'https://jitpack.io' }
+ }
+ }
+```
+
+
+2. Add the dependency in app gradle
+
+```groovy
+ dependencies {
+ implementation 'com.github.JDevZone:CheckableTextView:{latest_version}'
+ }
+```
+### Basic usage
+
+```xml
+
+```
+### Change State Programatically
+
+You can change checked state as follows :
+```kotlin
+checkedTV.setChecked(isChecked)
+```
+Default value `shouldNotifyListeners` is false
+
+***or***
+
+```kotlin
+checkedTV.setChecked(isChecked,shouldNotifyListeners)
+```
+ First Boolean parameter `isChecked` sets the current state
+ Second Boolean parameter `shouldNotifyListeners` determines
+ if `onCheckChange` method should be called or not.
+
+### Get Current State
+```kotlin
+checkedTV.isChecked()
+```
+No Fancy enums, Just true for checked state and false for unchecked is returned
+
+### Listen State Changes
+
+You can listen to state changes by registering a listener like as follows :
+```kotlin
+checkedTV.setOnCheckChangeListener()
+```
+and get callback in implemented method :
+```kotlin
+override fun onCheckChange(view: View, isChecked: Boolean) {
+ // checkedTV returned as view
+ // isChecked current state of the view
+ }
+```
+### Set Custom Interpolator
+
+```kotlin
+checkedTV.setAnimInterpolator(BounceInterpolator())
+```
+### Experimental
+
+```kotlin
+checkedTV.setClickEnabled(isClickable: Boolean)
+```
+Pass `isClickable` true for enable and false for disable clicks
+
+> currently restricted to `RestrictTo.Scope.LIBRARY`
+> you can use it simply Suppressing Lint Warnings (if have any) as `@SuppressLint("RestrictedApi")`
+
+### Customisation
+
+Here are the attributes you can specify through XML or related setters:
+* `ctv_Text` - Set text.
+* `ctv_TextSize` - Set text size.
+* `ctv_TextColor` - Set text color.
+* `ctv_TextStyle` - Set text style.
+* `ctv_Icon` - Set custom icon.
+* `ctv_IconTint` - Set icon tint.
+* `ctv_IconChecked` - Set TextView (`CheckableTextView`) state checked.
+* `ctv_TextGravity` - Set text gravity.
+* `ctv_AnimType` - Set check animation type currently three available (`scale`,`translate` and `fall_down`).
+* `ctv_AnimDuration` - Set duration for check animation.
+* `ctv_AnimFirstTime` - Animate `CheckableTextView` for very first time.
+* `ctv_RippleAlpha` - Set Alpha (Transparency) value for ripple like fill effect
+* `ctv_RippleTint` - Set color value for ripple like fill effect
+* `ctv_RippleFillEnabled` - Sets if ripple like fill effect is enabled or not
+
+
+### 📄 License
+
+Checkable TextView is released under the MIT license.
+See [LICENSE](./LICENSE) for details.
+
+
+