EcoHabit

EcoHabit.org

Table of Contents

• Table of Contents
• Project Description
• Tech Stack
• Getting Started
• Roadmap
• Socials
• Contribute
• Discuss

Project Description

EcoHabit is a web app project that aims to create awareness of the environment and help people build environmental friendly habits.

It will visualize users' habits by tracking their activities (recycling, commuting, eating, etc.) and encourage them to improve their habits with better alternative options.

It also targets to be users' go-to place to find the closest recycling locations and give them clear instructions about how to divide and recycle each material.

Tech Stack

• Frontend: React, Material UI (JavaScript)
• Backend: NodeJS/ExpressJS (JavaScript)
• Database: MongoDB

Getting Started

Prerequisites

• Download and install the latest version of Git on your system. See https://git-scm.com/downloads.
  • To make sure if your Git is on the latest version, run this command on the command line: git -v.
• Download and install the latest version of NodeJS and npm on your system. See https://nodejs.org/en/.
  • npm is included with the NodeJS installation. This means that you only have to download and run the NodeJS installer.
  • To make sure if your NodeJS is on the latest version, run this command on the command line: node -v.
  • To make sure if your npm is on the latest version, run this command on the command line: npm -v.

If you prefer the command line way of downloading and installing things, then feel free to do so. Otherwise, the instructions above should get you up and running.

How to Run

• Clone the repository for this project by running the following command in a terminal:

  git clone https://github.com/lugenx/ecohabit.git

• Open the cloned folder in VS Code. Open the terminal and make sure its pointing to the root of the cloned project.

• Running Backend Node JS Application:

  • Change the directory to server folder using terminal command: cd server
  • At the root of the server directory, create an .env file and copy the content from .env.example into the new .env file.
  • In the server directory, you can run:

  npm install

  • It'll download all the packages/dependencies as defined in package.json file. Once the system completes this process, we can type below command:

  npm start

  • Runs the app in the development mode.
  • You can start making http calls to http://localhost:3001

• Running Frontend React JS Application:

  • Change the directory to client folder using terminal command: cd client
  • In the client directory, you can run:

  npm install

  • It'll download all the packages/dependencies as defined in package.json file. Once the system completes this process, we can type below command:

  npm start

  • Runs the app in the development mode.

  • Open http://localhost:3000 to view it in the browser

  • The page will reload if you make edits.

  • You will also see any lint errors in the console.

MongoDb Setup Instructions

Install MongoDB:

 - Visit the MongoDB website and download the appropriate installer for your operating system.

Start MongoDB Server:

 - After installation, start the MongoDB server. The method for starting the server varies depending on your operating system.

Create a Database:

 - In your project, decide on the name of your MongoDB database.
 - In the MongoDB shell, switch to the desired database using the use <databaseName> command. If the database does not exist, MongoDB will create it when you first write data to it.

Connect to MongoDB from Your Application:

 - Install a MongoDB driver for your programming language. There are official MongoDB drivers available for most popular programming languages.
 - Use the connection string provided by MongoDB to connect to your database. This string typically includes information such as the host, port, and database name.
 - Initialize a connection to MongoDB in your application code using the provided driver and the connection string.

Roadmap

• List any features planned

Contribute

• EcoHabit appreciates your contribution in any aspects of project development like documenting, UI/UX design, Frontend/Backend development etc.
• Please try and follow below guidelines while creating a new PR:
  • Keep the PR size smaller(max 8 files).
  • Each PR should be atomic in nature and should be focused on single issue only.
  • Respective Issue shall be linked with the PR.
  • If there's no existing Issue for which PR needs to be raised, first create an Issue in the project and then wait for it to get assigned.
  • Before starting work on a new pull request, make sure you have been assigned to the related issue. To get assigned, please comment on the issue.
  • Naming conventions and folder structure shall remain consistent.
• If you have some Git experience but do not know how to contribute on a team project, we have a beginner friendly guide

Discuss

We are always looking for new members to join our community. One way to get involved is by joining our Discord server. On Discord, you can discuss the project, ask questions and receive support from other members of the community.