diff --git a/README.md b/README.md
new file mode 100644
index 0000000..08779c6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# ![RealWorld Example App](logo.png)
+
+> ### [YOUR_FRAMEWORK] codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the [RealWorld](https://github.com/gothinkster/realworld-example-apps) spec and API.
+
+
+### [Demo]()    [RealWorld](https://github.com/gothinkster/realworld)
+
+
+This codebase was created to demonstrate a fully fledged fullstack application built with [YOUR_FRAMEWORK] including CRUD operations, authentication, routing, pagination, and more.
+
+We've gone to great lengths to adhere to the [YOUR_FRAMEWORK] community styleguides & best practices.
+
+For more information on how to this works with other frontends/backends, head over to the [RealWorld](https://github.com/gothinkster/realworld) repo.
+
+
+# How it works
+
+> Describe the general architecture of your app here
+
+# Getting started
+
+> npm install, npm start, etc.
+