From 98c3f60ad54883cce0fc5528753f1ab120c02837 Mon Sep 17 00:00:00 2001
From: Jonathan Casarrubias <jcasarrubias@mean.expert>
Date: Thu, 22 Dec 2016 14:06:17 -0600
Subject: [PATCH] Added SETUP.md document

---
 .github/CONTRIBUTING.md |  8 ------
 SETUP.md                | 58 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+), 8 deletions(-)
 create mode 100644 SETUP.md

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index b9083f4..4824290 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -29,14 +29,6 @@ Always write a clear log message for your commits. One-line messages are fine fo
     
 Most of the times you will need to add a new test or we may not be able to integrate it. Though, there are some cases when you don't need to add a unit test, like fixing a typo, adding a missing type, etc.
 
-## Testing
-
-Tests are being created and excecuted by using the Angular-CLI Tool, please refer to the official documentation.
-
-````sh
-$ cd to/fireloop.io
-$ npm test 
-````
 
 Thanks,
 Jonathan Casarrubias, [MEAN Expert](http://mean.expert).
\ No newline at end of file
diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 0000000..30dab80
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,58 @@
+How to locally setup FireLoop
+==============
+
+If you want to start contributing or just because you want to have FireLoop locally installed, then you will need to read the following steps:
+
+## Clone FireLoop Repo
+First of all you need to clone the FireLoop repository from GitHub.
+
+````sh
+$ git clone git@github.com:mean-expert-official/fireloop.io.git
+````
+
+## FireLoop CLI
+The FireLoop CLI is a gateway that acts as an interface for the final user, thought it uses a couple of yeoman generators to work on the actual scaffolding.
+
+Since the FireLoop CLI is for users public entrace, you will require to `$npm link` this specific project locally running.
+
+> IMPORTANT: Make sure you globally uninstall previous versions of fireloop $ npm uninstall -g @mean-expert/fireloop
+
+````sh
+$ cd fireloop.io/fireloop-cli
+$ npm install 
+$ npm link
+````
+
+The commands described above will install local copy of the FireLoop CLI running from the code you just cloned.
+
+Any change you make within the fireloop-cli code, will be immediatly reflected within the command line interface functionality.
+
+## FireLoop Generator
+The FireLoop Generator is a yeoman generator that actually coordinates the setup of the project, sdk generations and it provides with the templates that transforms a regular LoopBack application into a FireLoop Application.
+
+The FireLoop Generator is written in TypeScript, the source code can be located within the `generator-fireloop/src` directory.
+
+When changes are made within the `generator-fireloop` source code and in order to test it, the very first thing you need to do is to compile the project:
+
+````sh
+$ cd fireloop.io/generator-fireloop/src
+$ tsc
+````
+
+The commands described above will generate the JavaScript code into the `fireloop.io/generator-fireloop/generators` directory.
+
+Now, in order for the local FireLoop client to use your code you will need install the code you just generated as follows:
+
+
+````sh
+$ cd fireloop.io/fireloop-cli
+$ npm install ../generator-fireloop
+````
+
+Don't use the --save or --save-dev flags because we don't want to persist the local reference into the package.json.
+
+After you install the compiled code into the FireLoop CLI you should be able see your modifications by using the fireloop command
+
+````sh
+$ fireloop
+````
\ No newline at end of file