WasteEasy

An app for waste classification and easy disposal, where users earn coupons by dumping waste.

View Demo . Report Bug . Request Feature

Table Of Contents

• Table Of Contents
• About The Project
• Built With
• Getting Started
  • Prerequisites
  • Installation
• Host your own
• Contributing
  • Creating A Pull Request
• Raising an issue
• Code of conduct
• License
• Authors

About The Project

WasteEasy is an app designed to streamline waste management. Developed during the Envision Hackathon, it focuses on waste classification and encourages proper waste segregation. Users can earn points or coupons by utilizing WasteEasy for their waste disposal needs.

Built With

• NextJs
• Bun
• NextJS
• TailwindCss
• MongoDb
• GoogleMaps
• Gemini

Getting Started

Prerequisites

Git is a distributed version control system used for software development. It allows multiple developers to work on the same codebase simultaneously, keeping track of changes and managing versions. It also enables users to revert changes and collaborate more effectively.

Bun is a JavaScript runtime, package manager, test runner bundler built from scratch using the Zig programming language. It was designed by Jarred Sumner as a drop-in replacement for Node.js. Bun uses JavaScriptCore as the JavaScript engine, unlike Node.js and Deno, which both use V8.

MongoDB is a source-available, cross-platform, document-oriented database program. Classified as a NoSQL database product, MongoDB utilizes JSON-like documents with optional schemas. MongoDB is developed by MongoDB Inc. and current versions are licensed under the Server Side Public License.

GoogleMaps Api key

Gemini Api Key

EmailJs

Installation

This project utilises Bun. Install it before running locally

git clone https://github.com/ShivaBhattacharjee/WasteEasy

cd WasteEasy

cp .env.example .env

Fill the required fields inside the .env before starting the server

bun install

bun dev

This will start the development server at http://localhost:3000/

Host your own

• Vercel

• Netlify

• Render

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it

• Please make sure you check your spelling and grammar.

Creating A Pull Request

Wanna contribute to WasteEasy ?

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/FeatureName)
3. Commit your Changes (git commit -m 'Add some FeatureName')
4. Push to the Branch (git push origin feature/FeatureName)
5. Open a Pull Request

Raising an issue

If you're experiencing any problems with WasteEasy, please be sure to review our issue template before opening a new issue. The template includes a list of questions and prompts that will help us better understand the issue you're experiencing, and it will ensure that we have all of the necessary information to investigate the problem.

We kindly ask that you provide as much detail as possible when submitting an issue, including steps to reproduce the problem, any error messages that you have seen, and any other relevant information. This will help us to identify and fix the issue more quickly.

Thank you for your cooperation, and we look forward to hearing from you!

Code of conduct

Developers are requested to go through our code of conduct thoroughly to maintain a peaceful environment within our project.

License

Distributed under the Apache License 2.0 . See LICENSE for more information.

Authors

• Shiva Bhattacharjee - Shiva Bhattacharjee - Waste Easy