Skip to content

A Platform for Reusing, Recycling, and Reducing Waste

Notifications You must be signed in to change notification settings

Hasib-39/Proyojon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Proyojon

React Firebase

🌍 A Platform for Reusing, Recycling, and Reducing Waste

Proyojon is a web platform designed to encourage sustainable living by allowing users to donate items they no longer need and help others find items they could use. By promoting reuse, recycling, and waste reduction, Proyojon aims to contribute to a greener and more sustainable future.

🚀 Features

  • User Registration & Authentication: Secure user registration and login using Firebase Authentication.
  • User Profile Management: Each user can manage their profile, view their donation history.
  • Item News Feed: A live feed where users can view available items for donation, including descriptions, photos, and more.
  • Item Search Functionality: Easily search for specific items based on keywords to quickly find what you need.
  • Real-Time Chat: Built-in real-time chat allowing donors and claimants to communicate seamlessly.

🛠️ Tech Stack

  • Frontend: React.js
  • Backend: Firebase (Database, Authentication, and Real-Time Communication)

📸 Screenshots

Home Screen

Screenshot 2024-11-14 010801

Chat UI

Screenshot 2024-11-14 010859

Favourites Page

Screenshot 2024-11-14 010946

Adding Post

image

Profile Page

image

📦 Getting Started

  1. Clone the repository:

    git clone https://github.com/Hasib-39/Proyojon.git
    cd Proyojon
  2. Install dependencies:

    npm install
  3. Configure Firebase:

    • Set up a Firebase project and add Firebase credentials to .env.
    • Update Firebase settings in the codebase as per your project configuration.
  4. Start the development server:

    npm start

    The app should now be running on localhost:3000.

📚 Usage

  • Donating/Selling Items: Users can add items they wish to donate, providing descriptions, photos, and location details.
  • Claiming Items: Browse through available items and claim ones that are needed.
  • Communication: Chat in real-time with donors to discuss pickup details or item specifics.

📈 Future Enhancements

  • Location-based Item Search
  • Enhanced Profile Customization
  • Integration with Google Maps API for Item Locations

🤝 Contributing

Contributions are welcome! Please fork the repository and create a pull request with your proposed changes.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


Proyojon: Making a difference, one item at a time 🌱

About

A Platform for Reusing, Recycling, and Reducing Waste

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •