-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Updated Readme for better documentation (#57)
- Loading branch information
1 parent
ad83e6f
commit 11d4558
Showing
3 changed files
with
126 additions
and
2,245 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,17 +1,60 @@ | ||
# Food - up | ||
# Food - Up : A Social Networking Website For Foodies!🍕 | ||
|
||
![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat) | ||
|
||
A social networking website for foodies! | ||
## Technologies Used👨🏻💻 | ||
|
||
## Tech used | ||
- Node js | ||
- Express js | ||
- Node JS | ||
- Express JS | ||
- MongoDB | ||
|
||
## Setup | ||
- You need NodeJS installed | ||
- Clone the repository | ||
- run ``` sudo npm install -g --force nodemon ``` | ||
- run ``` npm install ``` in the home directory | ||
- to test locally, run ``` nodemon app.js ``` and view the site on localhost:3000 | ||
## Requirements For Running The Project On Your System 👨🏻💻 | ||
|
||
### 🔷 NodeJs | ||
|
||
⚠️To begin with the Node JS installation process, first you need to make sure you have sufficient space and your RAM is at least 4GB | ||
|
||
#### Steps to set up NodeJS | ||
|
||
* Go to the official download page of [NodeJS](https://nodejs.org/en/download/) | ||
* In the downloads page, you will see various versions of Node. All you need to do is, click on the box, suitable to your system configurations (MAC, Windows Or Linux). | ||
* Once you have successfully downloaded the software, go to the downloaded file, and double-click on it. | ||
* As soon as you click on the file, an installation wizard will come up. Select ‘Next’ and move further with the installation. | ||
* After the installation is done, NodeJs is successfuly set up. You can run ```node --version``` to confirm the installation. | ||
|
||
### 🔷 Git | ||
|
||
#### Steps to set up Git | ||
|
||
* Go to the official [download page](https://git-scm.com/downloads) and download the installer for your OS. | ||
* Proceed with the installation step as recommended by the installer. ⚠️It's not recommended to enable settings not recommended by the installer by default. | ||
* Git will be installed on your system, By running ```git --version``` you can verify the success of the installation. | ||
|
||
### 🔷 ExpressJs (Optional) | ||
|
||
#### Steps to set up ExpressJS | ||
|
||
* Since you have already got NodeJS installed, we can take help of the Node Package Manager (**NPM**) ,to proceed with the installation of ExpressJS. | ||
* Go to your terminal and run the command ```npm install express``` | ||
* The node package manager will install the latest version of ExpressJS on your system. | ||
|
||
## Setting Up The Project On Your System💻 | ||
|
||
### 🔶 Cloning The Repository | ||
|
||
#### Since you have already set up Git, it's going to be a piece of cake 🍰 | ||
|
||
* Create a new folder where you would like the files of the repository to go. | ||
* open the windows terminal on the diectory and run ```git clone https://github.com/AMU-Code-Squad/food-up``` | ||
* Done!🎉 ,Git will clone all the files into your system. | ||
|
||
### 🔶 Getting The Dependencies Ready & Running The Server | ||
|
||
#### As we have now cloned the repository, it's time to get all the dependencies required to run the app, to do this simply run the following two commands in the terminal | ||
|
||
* For Windows - ```npm install -g --force nodemon``` | ||
* For Linux, run ```sudo npm install -g --force nodemon``` | ||
* Run ```npm install``` in the home directory, to let npm install all the essential packages from package.json | ||
* Finally! To runt the project on your systme, type ```nodemon app.js``` on the terminal and view the site on ```http://localhost:3000/``` 🥳 | ||
|
||
> If You are a contributor in this project, Be sure to add your name on https://amu-code-squad.github.io 😎 |
Oops, something went wrong.