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.
- Front End: React (JavaScript), Material UI
- 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: '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 Nods JS Application:
- Change the directory to server folder using terminal command: cd server
- 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
-
Running Frontend React JS Application:
- Change the directory to server 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.
- List any features planned
- List contributors and their social links, if any
-
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 need to be raised, first create an Issue in the project and then create the PR.
- 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