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.
- Frontend: React, Material UI (JavaScript)
- Backend: NodeJS/ExpressJS (JavaScript)
- Database: MongoDB
- 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.
- To make sure if your Git is on the latest version, run this command on the command line:
- 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.
-
Clone the repository for this project by running the following command in a terminal:
-
Open the cloned folder in VS Code. Open the terminal and make sure its pointing to the root of the cloned project.
-
Create Database for development use:
- Create a mongodb account through the MongoDB Website
- Create a cluster (by default is Cluster0 which can be used)
- Once the cluster is up, you need to click on the 'Connect' tab
- Follow the drivers section to retrieve the mongodb connection url and save it for the next steps
- Connection url - mongodb+srv://(username):(password)@cluster0.xqzlrqf.mongodb.net/(databasename)?retryWrites=true&w=majority
- Replace the username and password you used for the mongo db account and put a databasename (eg. ecohabit)
-
Run the backend NodeJS 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.
- Update the 'MONGODB_URL' property in the .env file with the mongodb connection url saved
- In the server directory, you can run:
- It'll download all the packages/dependencies as defined in package.json file. Once the system completes this process, we can type below command:
- Runs the app in the development mode.
- You can start making http calls to http://localhost:3001
- Change the directory to server folder using terminal command:
-
Running Frontend React JS Application:
- Change the directory to client folder using terminal command:
cd client - In the client directory, you can run:
- It'll download all the packages/dependencies as defined in package.json file. Once the system completes this process, we can type below command:
-
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.
- Change the directory to client folder using terminal command:
-
Insert habit dummy data:
- Go back to the MongoDB website to your project.
- The collection with the databasename you provided will be present (created when you started the server app)
- Inside the collection, you will find 'habits' as a subcollection
- Open it and you can insert the below dummy documents
{
"category": "Recycle",
"description": "Reduce the amount of waste by using reusable bags!",
"question": "Which one of these did you use today?",
"answerOptions": ["Reusable bag", "Plastic bag", "Both", "None"]
}
{
"category": "Commute",
"description": "Carpool with coworker or friends",
"question": "How did you commute to work today?",
"answerOptions": ["Drived", "Carpooled", "Bike", "Public Transport"]
}
{
"category": "Recycle",
"description": "Separate your recycble materials",
"question": "Did you separate your recycble materials today?",
"answerOptions": ["Yes", "No"]
}
-
Note: When you insert a document, append the above json fields to the already defined unique id in the document
-
The link MongoDB Insert Document shows how to insert the document in the mongodb manually through the UI
- The page will reload if you make edits.
- You will also see any lint errors in the console.
- List any features planned
- 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
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.
