diff --git a/README.md b/README.md
new file mode 100644
index 0000000..38cd0a5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+App deployed at : https://warblarblarg.herokuapp.com/
+
+<a href="https://warblarblarg.herokuapp.com/"><img src="assets/Warbler_Landing_Page.png" title="WarBlarBlarg" alt="WarBlarBlarg"></a>
+
+# Warblar - Twitter Clone 
+
+> Warblar is a twitter clone with full CRUD on 'warbles' or tweets.  The site offers full features such as following/followers, sign up and authentication (encryption using bcrypt), warbles and more!
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Features](#features)
+- [Team](#team)
+
+## Installation
+
+```shell
+python -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+flask run
+```
+
+
+### Features
+<ul>
+
+<li>Users can sign up with a password protected account.</li>
+<li>Users can "like", post and follow "warbles" or tweets.</li>
+<li>Full unit and integration tests.</li>
+<li>Passwords encrypted and stored in database.</li>
+<li>Full CRUD on user profiles as well as "warbles".</li>
+</ul>
+<img src=”https://github.com/Lulzasaur/Warbler/raw/master/assets/Warbler_Home_Page.png”></img>
+
+Team
+| Victor Marks | github.com/silasburger |