diff --git a/README.md b/README.md
index 4c1fcf8..cdb71c1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,44 @@
 # Liquid Pledging
 
+> Ethereum contract to delegate donations to projects.
+
 [![Build Status](https://travis-ci.org/Giveth/liquidpledging.svg?branch=master)](https://travis-ci.org/Giveth/liquidpledging)
+
+Welcome to the code for the liquidpledging contract, a new way to distribute donated ether while keeping ownership in the hands of the original donor.
+
+## Table of content
+
+- [Getting Started](#getting-started)
+    - [Install](#install)
+    - [Requirements](#requirements)
+    - [Package](#package)
+- [Run demo](#run-demo)
+- [Help](#help)
+
+### Install
+1. Click **Star** on this repo near the top-right corner of this web page.
+2. Join our [slack](http://slack.giveth.io) if you haven't already.
+3. Fork this repo by clicking **Fork** button in top-right corner of this web page. Continue to follow instruction steps from your own liquidpledging repo.
+5. The rest of these steps must be done from your machine's command line. Clone your own "liquidpledging" repo: 
+    ```
+    git clone https://github.com/GITHUB_USERNAME/liquidpledging.git
+    ```
+6. Change directories to liquidpledging:
+    ```
+    cd liquidpledging
+    ```
+
+### Requirements
+Make sure you have [NodeJS](https://nodejs.org/) (v8.4.0 or higher) and [npm](https://www.npmjs.com/) (5.4.1 or higher) installed.
+
+### Package
+The liquidpledging contract is published as an npm package for developer convenience. To include it as a dependency in your package.json run this from your apps root dirctory.
+```
+ npm install liquidpledging --save
+```
+
+## Run demo
+Follow the instructions on the [liquidpleding-demo](https://github.com/ojones/liquidpledging-demo) repo.
+ 
+## Help
+Reach out to us on [slack](http://slack.giveth.io) for any help or to share ideas.
\ No newline at end of file