diff --git a/README.md b/README.md
index 71ffa2f0..72ca63e7 100644
--- a/README.md
+++ b/README.md
@@ -1,705 +1,1106 @@
-# Branch Metrics Cordova/Ionic/Phonegap SDK Reference
+# Branch for Cordova/PhoneGap/Ionic
+*Questions? [Contact us](https://support.branch.io/support/tickets/new)*
+
+- [Integration](#integration)
+ - [Configure Branch](#configure-branch)
+ - [Install Branch](#install-branch)
+ - [Configure App](#configure-app)
+ - [Initialize Branch](#initialize-branch)
+ - [Listen Deep Link](#listen-deep-link)
+ - [Test Deep Link iOS](#test-deep-link-ios)
+ - [Test Deep Link Android](#test-deep-link-android)
+- [Features](#features)
+ - [Initialize Branch Features](#initialize-branch-features)
+ - [Create Content Reference](#create-content-reference)
+ - [Create Deep Link](#create-deep-link)
+ - [Share Deep Link](#share-deep-link)
+ - [Read Deep Link](#read-deep-link)
+ - [Display Content](#display-content)
+ - [Track Content](#track-content)
+ - [Track User](#track-user)
+ - [Track Event](#track-event)
+ - [Handle Referrals](#handle-referrals)
+- [Troubleshooting](#troubleshooting)
+ - [Testing: Key Points](#testing-key-points)
+ - [Testing: Sample Testing App](#testing-sample-testing-app)
+ - [Testing: Sample Integration App](#testing-sample-integration-app)
+ - [Testing: Show Console Logs](#testing-show-console-logs)
+ - [Testing: Supported Platforms](#testing-supported-platforms)
+ - [Testing: Simulating an Install](#testing-simulating-an-install)
+ - [Link Domain: Custom](#link-domain-custom)
+ - [Link Domain: Bnc.lt](#link-domain-bnclt)
+ - [Link Data: Convert to Ionic/Angular](#link-data-convert-to-ionicangular)
+ - [Link Data: Depreciated Methods](#link-data-depreciated-methods)
+ - [Compiling: Updating the Branch SDK](#compiling-updating-the-branch-sdk)
+ - [Compiling: Cordova Dependencies](#compiling-cordova-dependencies)
+ - [Compiling: Visual Studio TACO](#compiling-visual-studio-taco)
+ - [Compiling: Multiple support-lib v4s](#compiling-multiple-support-lib-v4s)
+ - [Compiling: Missing Android Dependency](#compiling-missing-android-dependency)
+- [Additional Documentation](#additional-documentation)
+
+# Integration
+
+- #### Configure Branch
+
+ - Complete your [Branch Dashboard](https://dashboard.branch.io/settings/link)
+
+ - Example
+ ![image](http://i.imgur.com/tkEolFM.png)
+
+
+- #### Install Branch
+
+ - Change `key_live_hiuejxqEdbHR8Tc1L92nmiijrse9OBpq`, and `branchcordova` to the values in your [Branch Dashboard](https://dashboard.branch.io/settings/link)
+
+ - Cordova and PhoneGap and Ionic
+ ```sh
+ # terminal
+ cordova plugin remove io.branch.sdk;
+ cordova plugin add branch-cordova-sdk --variable BRANCH_KEY=key_live_hiuejxqEdbHR8Tc1L92nmiijrse9OBpq --variable URI_SCHEME=branchcordova;
+ ```
+
+
+- #### Configure App
+
+ - Change `com.eneff.branch.cordova`, `PW4Q8885U7`, `2d0s.app.link`, and `2d0s-alternate.app.link` to the values in your [Branch Dashboard](https://dashboard.branch.io/settings/link)
+
+ - Cordova and Ionic
+ ```xml
+
+
+
+
+
+
+
+ ```
+
+
+ - PhoneGap
+ ```xml
+
+
+
+
+
+
+
+ ```
+
+
+- #### Initialize Branch
+
+ - Cordova and PhoneGap
+ ```js
+ // sample index.js
+ var app = {
+ initialize: function() {
+ this.bindEvents();
+ },
+
+ bindEvents: function() {
+ document.addEventListener("deviceready", this.onDeviceReady, false);
+ },
+ onDeviceReady: function() {
+ BranchInit(true);
+ },
+
+ function BranchInit(isDebug) {
+ Branch.setDebug(isDebug); // for development and debugging only
+ Branch.initSession().then(function(res) {
+ console.log(res);
+ }).catch(function(err) {
+ console.error(err);
+ });
+ }
+ };
+
+ app.initialize();
+ ```
+
+
+ - Ionic 1
+ ```js
+ // sample app.js
+ .run(function($ionicPlatform) {
+ $ionicPlatform.ready(function() {
+
+ $ionicPlatform.on("deviceready", function(){
+ BranchInit(true);
+ });
+
+ function BranchInit(isDebug) {
+ Branch.setDebug(isDebug); // for development and debugging only
+ Branch.initSession().then(function(res) {
+ console.log(res);
+ }).catch(function(err) {
+ console.error(err);
+ });
+ }
+ });
+ })
+ ```
+
+
+ - Ionic 2
+ ```typescript
+ // sample app.component.js
+ declare var Branch;
+
+ @Component({
+ // ...
+ })
+
+ export class MyApp {
+ constructor(platform: Platform) {
+ platform.ready().then(() => {
+
+ // Branch
+ Branch.setDebug(isDebug); // for development and debugging only
+ Branch.initSession().then(function(res) {
+ console.log(res);
+ }).catch(function(err) {
+ console.error(err);
+ });
+ });
+ }
+ }
+ ```
+
-This is the repository of the [Branch Metrics](https://branch.io/) open source Cordova | Phonegap | Ionic SDK.
+- #### Listen Deep Link
-## Get the Demo App
+ - `DeepLinkHandler` must be a global function and does not have to be in `index.html`
-There's a full demo app embedded in this repository. It should serve as an example integration and help guide you in resolving any bugs you encounter. If you think you've got a bug, please first check that it's present in the demo app before writing in. You can find [the source here](https://github.com/BranchMetrics/cordova-ionic-phonegap-branch-deep-linking/blob/master/testbed).
+ - Cordova and PhoneGap and Ionic
+ ```html
+
+
+