adding the initial starting your first app section

Author: ekryski

SUMMARY.md

@@ -11,7 +11,7 @@
        * [Parse](getting-started/vs/parse.md)
        * [Pusher](getting-started/vs/pusher.md)
    * [Quick Start](getting-started/quick-start.md)
-   * [Your First App](getting-started/your-first-app.md)
+   * [Your First App](getting-started/your-first-app/readme.md)
 * [Services](services/readme.md)
 * [REST](providers/rest.md)
 * [Real-Time](providers/real-time/readme.md)
@@ -48,7 +48,7 @@
    * React and React Native
    * CanJS
 * [Help](help/readme.md)
-   * [FAQ](faq.md)
+   * [FAQ](help/faq.md)
 * [Contributing](contributing.md)
 * [Changelog](changelog.md)
 * [License](license.md)

contributing.md

@@ -4,7 +4,7 @@ Just like Feathers itself, all of the documentation is open source and [availabl
 
 ## Contributing Guidelines
 
-The docs are all written in [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/).  If you've used GitHub, it's pretty likely you've encountered it before.  You can become a pro in a few minutes by reading their [GFM Documenation page](https://help.github.com/articles/github-flavored-markdown/).
+The docs are all written in [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/).  If you've used GitHub, it's pretty likely you've encountered it before.  You can become a pro in a few minutes by reading their [GFM Documentation page](https://help.github.com/articles/github-flavored-markdown/).
 
 ### Organizing Files
 

getting-started/quick-start.md

@@ -14,7 +14,7 @@ Generate your app and follow the prompts.
 
 `yo feathers`
 
-Start your brand new app! :boom:
+Start your brand new app! 💥
 
 `npm start`
 
@@ -26,4 +26,4 @@ Start your brand new app! :boom:
 
 In just a couple minutes we created a real-time API that is accessible via REST and websockets! Based on the options you chose it connected to your database, already provides CORs, authentication, sane rate limiting, pagination, logging, error handling, and a few other goodies.
 
-This is a great start! Let's take this a bit further and [build your first real application](your-first-app.md).
+This is a great start! Let's take this a bit further and [build your first real application](your-first-app/readme.md).

getting-started/your-first-app.md

@@ -0,0 +1,68 @@
+# Your First App
+
+Well alright! Let's build your first Feathers app! We're going to build a real-time chat app with MongoDB as the database. It's a great way to cover all the things that you'd need to do in a real world application and how Feathers can help. It also makes a lot more sense to have a real-time component than a Todo list. 😉
+
+If you've already gone through the [Quick Start](quick-start.md) section you can skip ahead to [What Just Happened?](#what-just-happened).
+
+## Generate Your App
+
+Make sure you have NodeJS and npm installed. You can grab these from the [NodeJS](https://nodejs.org) website or if you are on OS X and have homebrew installed by running `brew install nodejs`.
+
+Install the Yeoman and the Feathers generator.
+
+> `npm install -g yeoman generator-feathers`
+
+Create a directory for your new app.
+
+> `mkdir feathers-chat; cd feathers-chat/`
+
+Generate your app and follow the prompts.
+
+`yo feathers`
+
+When presented with the project name just hit enter.
+
+<img src="./assets/step1.png" alt="App Name Prompt">
+
+Enter in a short description of your app.
+
+<img src="./assets/step2.png" alt="App Description Prompt">
+
+You can now choose which providers you want to support. Since we're setting up a real-time REST API we'll go with the default REST and Socket.io. So just hit enter.
+
+You can learn more about Feathers providers in [Providers chapter](providers/readme.md).
+
+<img src="./assets/step3.png" alt="Transport Prompt">
+
+Next we'll be prompted to support [CORs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS). This basically allows your client to connect to the sever from wherever. You can whitelist specific domains but again, just hit enter for now.
+
+<img src="./assets/step4.png" alt="CORs Prompt">
+
+Now let's choose our database. You can see that Feathers supports a bunch through the generator and we support even more outside the generator. Let's choose MongoDB. You can find out more about our database adapters in the [Databases chapter](databases/readme.md).
+
+<img src="./assets/step5.png" alt="Database Prompt">
+
+Since pretty much every app needs authentication of some sort we generate almost everything you need to get going. We currently only support local authentication but have plans for social auth as well.
+
+You can learn more about authentication in Feathers by reading the [Authentication chapter](authentication/readme.md).
+
+<img src="./assets/step6.png" alt="Authentication Prompt">
+
+Your options should all look like this and you should have seen that a whole bunch of files were created.
+
+<img src="./assets/step7.png" alt="Final Configuration">
+
+npm will do it's thing and install your dependencies. Depending on your Internet connection this can take a minute or two. So while this is happening you should start your mongodb instance.
+
+If you are running on OSX or Linux and already have MongoDB installed simply run:
+
+`mongod`
+
+Once your dependencies have been installed you can start your brand new app! 💥
+
+`npm start`
+
+## What Just Happened
+
+
+

getting-started/your-first-app/assets/step1.png

@@ -2,4 +2,4 @@
 
 There are many ways that you can get help but before you explore them please check other parts of this guide, the [FAQ](faq.md), [Stackoverflow](http://stackoverflow.com/questions/tagged/feathersjs), [Github Issues](https://github.com/feathersjs/feathers/issues) and our Medium publication ["All About FeathersJS"](https://medium.com/all-about-feathersjs).
 
-If none of those work it's a very real possibility that we screwed something up or it's just not clear. We're sorry :cry:. We want to know about it and are very friendly so feel free to come talk to us in [Slack](http://slack.feathersjs.com/), [submit your issue](https://github.com/feathersjs/feathers/issues/new) on Github or ask on [StackOverflow](http://stackoverflow.com) using the [feathersjs](http://stackoverflow.com/questions/tagged/feathersjs) tag.
+If none of those work it's a very real possibility that we screwed something up or it's just not clear. We're sorry 😥. We want to know about it and are very friendly so feel free to come talk to us in [Slack](http://slack.feathersjs.com/), [submit your issue](https://github.com/feathersjs/feathers/issues/new) on Github or ask on [StackOverflow](http://stackoverflow.com) using the [feathersjs](http://stackoverflow.com/questions/tagged/feathersjs) tag.