diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d7eef6d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Webrtc-ratchet-chat-app
+A text, audio and video chat application built with webRTC and Ratchet
+
+# Requirements
+- PHP >= 5.4
+- Every other required files are included or referenced as the case may be
+
+# Getting Started
+To test this app on your local server:
+- The Ratchet server must be ON. This can be achived by navigating to *__webrtc-ratchet-chat-app/ws/bin__* from your cli and run *__php server.php__*
+- Run the app from your browser at: `http://localhost/webrtc-ratchet-chat-app/`
+- Create a room and get link to room
+- Open the links from two different browsers and test by sending text chats
+- The audio and video call is best tested on two different devices. This will require more configuration
+ - Open `webrtc-ratchet-chat-app/config.php` and change this line `define('WS_URL', 'ws://localhost:8080/comm');` to `define('WS_URL', 'ws://YOUR_SERVER_IP:8080/comm');`
+ - Open __`webrtc-ratchet-chat-app/ws/bin/server.php`__ and add your server `ip address` to __`$allowed_origins`__ array, then replace the __`localhost`__ in __`$app = new Ratchet\App('localhost', 8080, '0.0.0.0');`__ with your `ip address`
+ - Blam! Good to go. Navigate to __`YOUR_IP_ADDRESS/webrtc-ratchet-chat-app`__ on your browser on two different devices to keep video calling
+- Works best on Chrome, Firefox and the latest versions of Opera desktop browser.