Skip to content

Commit

Permalink
Updated Readme for better documentation (#57)
Browse files Browse the repository at this point in the history
  • Loading branch information
Lordhacker756 authored Jan 14, 2022
1 parent ad83e6f commit 11d4558
Show file tree
Hide file tree
Showing 3 changed files with 126 additions and 2,245 deletions.
65 changes: 54 additions & 11 deletions README.md
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 😎
Loading

0 comments on commit 11d4558

Please sign in to comment.