🎗 HelpingHands - NGO Donation & Volunteer Management Platform

“Empowering kindness through code.”

Welcome to *HelpingHands, a beautifully designed, beginner-friendly, and powerful web app for *NGOs, Non-Profits, or Donation-Based Platforms to manage inventory, volunteers, and donors seamlessly.

---

🌟 Features at a Glance

✅ User Authentication (Sign Up / Log In)
✅ Admin Dashboard to manage all activities
✅ Volunteer & Donor Registration
✅ Inventory Management with quantities and dates
✅ Donation Tracking
✅ Edit/Delete functionality for all modules
✅ Flash Alerts after actions (e.g., registered successfully)
✅ Responsive Design (Bootstrap + EJS)
✅ Search Box UI (future scalable)
✅ Role-based user system – Admin | Donor | Volunteer

---

🎯 Why Use This?

Imagine running an NGO where tracking every item donated, every volunteer who joins, or every inventory stock becomes overwhelming.

HelpingHands solves that with:

• 🎯 Simplicity — Clean UI, minimal clicks.
• 🛠 Maintainability — Clean folder structure, easy to extend.
• 💡 Beginner-Friendly Stack — No crazy dependencies, just powerful code.
• 🌱 Customizable — Use for your NGO, college project, or real deployment.

---

🛠 Tech Stack

Technology	Usage
HTML, CSS, Bootstrap	Frontend styling & layout
JavaScript	Client-side validation, logic
Node.js & Express.js	Server-side logic & routing
MongoDB & Mongoose	Database and schema modeling
EJS Templating	Dynamic HTML rendering
Bcrypt	Password hashing & security
Method-Override	Handling PUT/DELETE in forms
Express-Session	Session handling for login
Flash	User feedback (Success/Error)

---

🔐 User Roles & Permissions

Role	Permissions
Admin	Full control: add/edit/delete/view everything
Volunteer	Can register and be tracked for availability
Donor	Can register and donate items

---

📸 Screenshots

You can add some screenshots here like:

• 📦 Sign Up Page

• 

• 🖼 Admin Dashboard

• 📋 Inventory Form

• 👥 Volunteer List

---

🚀 Getting Started

1️⃣ Clone the repository

git clone https://github.com/your-username/helpinghands.git
cd helpinghands

2️⃣ Install dependencies

npm install

3️⃣ Set up .env file

PORT=8080
MONGO_URI=your_mongodb_connection_string
SESSION_SECRET=your_secret

4️⃣ Run the server

node app.js

Visit: http://localhost:8080


---

📂 Folder Structure

.
├── views/               # EJS templates
│   ├── partials/        # Header & Footer
│   ├── admin-*          # Dashboard pages
│   ├── donation.ejs     # Donation form
│   └── signup.ejs       # User Registration
├── models/              # Mongoose schemas
├── public/              # CSS, images, JS
├── routes/              # Express routes (optional modularization)
├── app.js               # Main server file
└── README.md


---

💡 Future Scope

📊 Add charts for donation/inventory stats

🧠 Add AI-based suggestions for low-stock items

🌍 Deploy on Render/Heroku/Vercel

📱 Mobile-first UI update

🔍 Add working search & filter logic



---

🙌 Author

Made with 💛 by Srinjoyee Dey
“Still learning. Always building. Forever growing.”


---

🧑‍💻 Contribute

Have suggestions or improvements?
Feel free to fork and raise a pull request! PRs and stars are always welcome ⭐


---

📃 License

This project is open-source.


---

🌈 Support & Feedback

If you like this project or it helped you in any way:

🌟 Star it

🗣 Share it

🧵 Tweet it


> Your support motivates me to build even more amazing stuff. Let’s help the world, one line of code at a time.



---

This project is chef’s kiss 👏🔥