##_**DISCLAIMER**_

This project has moved maintainers and is no longer developed here. The up to date template can be found [here](https://github.com/rennemannd/MERN-Template).

This project does not have a mongoDB connection setup. Setup the connection based on the environments below.

- local development: create a config file (make sure to name it config.js) in the config folder, which exports your db.uri connection. An example is provided, config/config.example.js. This file will be ignored by git so your db credentials will be kept safe when the app is deployed.

- production: Since the config file is not pushed when you deploy your app, you must specifiy your db uri in heorku. Set the uri in heroku as specified in [this](https://devcenter.heroku.com/articles/config-vars) resource. Make sure you name the environement variable "DB_URI".

This repository aims to assist you in beginning work on a MERN stack application with a solid file structure as a foundation. To get started make a copy of this template repo for your project teams.

Since this project will hold both the client application and the server application there will be node modules in two different places. First run `npm install` from the root. After this you will run `npm run-script install-all` from the root. From now on run this command anytime you want to install all modules again. This is a script we have defined in package.json .

This app can be deployed directly to heroku since there is a script defined in package.json which will automatically handle building and deploying the app. For more information on deploying to heroku reference the extra resources at the bottom of this file.

- #### `public` - This holds all of our static files

- #### `src`

- #### `assets` - This folder holds assets such as images, docs, and fonts

- #### `components` - This folder holds all of the different components that will make up our views

- #### `views` - These represent a unique page on the website i.e. Home or About. These are still normal react components.

- #### `App.js` - This is what renders all of our browser routes and different views

- #### `index.js` - This is what renders the react app by rendering App.js, should not change

- #### `package.json` - Defines npm behaviors and packages for the client

- #### `config` - This holds our configuration files, like mongoDB uri

- #### `controllers` - These hold all of the callback functions that each route will call

- #### `models` - This holds all of our data models

- #### `routes` - This holds all of our HTTP to URL path associations for each unique url

- #### `tests` - This holds all of our server tests that we have defined

- #### `server.js` - Defines npm behaviors and packages for the client

In the project directory, you can run:

Runs both the client app and the server app in development mode.<br>

Open [http://localhost:3000](http://localhost:3000) to view the client in the browser.

Runs just the client app in development mode.<br>

Open [http://localhost:3000](http://localhost:3000) to view the client in the browser.

Runs just the server in development mode.<br>

Builds the app for production to the `build` folder.<br>

It correctly bundles React in production mode and optimizes the build for the best performance.

If deploying to heroku this does not need to be run since it is handled by the heroku-postbuild script<br>

See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.

You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).

To learn how to setup a local MongoDB instance for testing, check out how to [Connect to MongoDB](https://docs.mongodb.com/guides/server/drivers/).

To learn how to deploy a full-stack web app to heroku, check out [this great guide](https://daveceddia.com/deploy-react-express-app-heroku/).

To learn React, check out the [React documentation](https://reactjs.org/).

This section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify