Update readme

Author: nurdtechie98

README.md

@@ -1,11 +1,60 @@
 # webdriverio-appium-app-browserstack
-[WebdriverIO](http://webdriver.io/) Integration with BrowserStack.
+This repository demonstrates how to run Appium tests using [WebdriverIO](http://webdriver.io/) on BrowserStack App Automate.
 
-![BrowserStack Logo](https://d98b8t1nnulk5.cloudfront.net/production/images/layout/logo-header.png?1469004780)
-
-<img src = "http://webdriver.io/images/webdriverio.png" height = "100">
+<div align="center">
+<img src = "https://www.browserstack.com/images/layout/browserstack-logo-600x315.png" > <br>
+<img src = "https://webdriver.io/img/webdriverio.png"  height="140px">
+</div>
 
 Code samples to get started with Appium tests for your Native App using WebdriverIO.
 
-## Resources
-* [Get Started guide](https://www.browserstack.com/app-automate/appium-webdriverio)
+## Setup
+-----------
+### Requirements
+* Node.js
+  - Install at least **v8.11.2 or higher** as this is the oldest active LTS version
+  - If you don't have Node installed, you can get get it installed from [here](https://nodejs.org/en/)
+
+### Install Dependencies
+To install the dependencies for Android tests, run :
+```sh
+cd android
+npm i
+```
+Or,
+To install the dependencies for iOS tests, run :
+```sh
+cd ios
+npm i
+```
+
+## Getting Started
+-----------
+Getting Started with Appium tests using WebdriverIO on BrowserStack couldn't be easier!
+
+### Run first test:
+  - Switch to `run_first_test` directory under [Android examples](./android) or [iOS examples](./ios)
+  - Follow the steps outlined in the documentation - [Get Started with your first test on App Automate](https://www.browserstack.com/docs/app-automate/appium/getting-started/nodejs/webdriverio)
+
+### Speed up test execution with parallel testing :
+
+- Switch to `run_parallel_test` directory under [Android examples](./android) or [iOS examples](./ios)
+- Follow the steps outlined in the documentation - [Get Started with parallel testing on App Automate](https://www.browserstack.com/docs/app-automate/appium/getting-started/nodejs/webdriverio/parallelize-tests)
+
+### Use Local testing for apps that access resources hosted in development or testing environments :
+
+- Switch to `run_local_test` directory under [Android examples](./android) or [iOS examples](./ios)
+- Follow the steps outlined in the documentation - [Get Started with Local testing on App Automate](https://www.browserstack.com/docs/app-automate/appium/getting-started/nodejs/webdriverio/local-testing)
+
+**Note**: If you are facing any issues, refer [Getting Help section](#Getting-Help)
+
+
+## Integration with other Java frameworks
+-----------
+For other test frameworks supported by App-Automate refer our [Developer documentation](https://www.browserstack.com/docs/)
+
+
+## Getting Help
+-----------
+If you are running into any issues or have any queries, please check [Browserstack Support page](https://www.browserstack.com/support/app-automate) or [get in touch with us](https://www.browserstack.com/contact?ref=help).
+