DUHacks4.0

Donation Platform : SocialConnect

📌 Project Overview

The NGO Donation Platform is a MERN stack-based web application that connects NGOs with potential donors. NGOs can register on the platform and request necessary items, while users can browse NGOs, view their requests, and donate accordingly. Users also have the option to donate directly without selecting a specific request.

🛠 Tech Stack

• Frontend: React, React Router, Redux, HTML, CSS, JavaScript
• Backend: Node.js, Express.js
• Database: MongoDB
• Authentication: JWT (JSON Web Token)
• API Integration: Google Maps API (for NGO geo-tagging)
• Tools & IDEs: IntelliJ IDEA, VS Code

🚀 Features

🔹 For NGOs:

• Register/Login
• Request needed items
• Manage requests
• View donations received

🔹 For Users:

• Register/Login
• View list of registered NGOs
• View detailed information of an NGO
• Check the list of requests made by an NGO
• Donate to a specific request
• Directly donate without selecting a request

⚙️ Installation and Setup

Prerequisites:

• Node.js & npm installed
• MongoDB installed and running
• Git installed

Steps:

1. Clone the Repository

   git clone https://github.com/yourusername/ngo-donation-platform.git
   cd ngo-donation-platform

2. Setup Backend

   cd backend
   npm install
   npm start

3. Setup Frontend

   cd frontend
   npm install
   npm run dev

4. Environment Variables (.env file) Create a .env file in the backend folder and add:

   MONGO_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret

5. Access the Application

   • Open http://localhost:5173 for the frontend (default Vite port)
   • Backend runs on http://localhost:5000

🗂 Folder Structure

ngo-donation-platform/
│── backend/
│   ├── models/
│   ├── routes/
│   ├── controllers/
│   ├── config/
│   ├── server.js
│   ├── .env
│
│── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── redux/
│   ├── App.js
│   ├── index.js
│
│── README.md
│── package.json
│── .gitignore

🎯 Future Enhancements

• Payment gateway integration for monetary donations
• User dashboard for tracking donations
• Admin panel for platform moderation
• Email notifications for NGOs and users

👨‍💻 Team

• Pruthvirajsinh Parmar
• Dhruvik Modi
• Parthrajsinh Kosamiya
• Dhruval Mehta

🤝 Contributing

We welcome contributions! Feel free to submit a pull request or raise an issue.

📜 License

This project is licensed under the MIT License.

📩 Contact

For any queries, reach out at [email protected] or create an issue in the repository.