Skip to content

Tarun-yadav355/Hopelist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧡 Hopelist – Donation Wishlist Platform for NGOs & Orphanages

Hopelist is a React-based web platform built to bridge the gap between donors and orphanages/NGOs. It allows organizations to list items they need, while donors can browse and contribute with transparency and ease.


🚀 Features

  • 🎯 View real-time donation needs of NGOs and orphanages
  • 📝 Dynamic wishlist creation by organizations
  • 🧾 Item-specific listings with quantity and description
  • 📱 Fully responsive UI with Material UI
  • 🔍 Simple, intuitive interface for donors
  • 📦 Ready for integration with backend APIs or Firebase

🛠️ Tech Stack

  • React.js (Frontend library)
  • Material UI (UI components and styling)
  • JavaScript (Functional logic)
  • HTML5 + CSS3 (Structure & layout)
  • Optional: Firebase/Node.js (for backend integration)

📸 Screenshots

(Add screenshots of homepage, NGO cards, item list, etc. here)
You can use tools like Lightshot, Snipping Tool, or Vercel Preview for this.


📂 Folder Structure

src/
├── components/          # Reusable UI components
│   ├── NgoCard.js
│   ├── Wishlist.js
│   └── ...
├── pages/               # Main route views (Home, NGO list)
├── assets/              # Images and static files
├── App.js
└── index.js

🧪 How to Run Locally

# Clone the repository
git clone https://github.com/Tarun-yadav355/hopelist.git
cd hopelist

# Install dependencies
npm install

# Start the development server
npm start

🤝 Contributing
Pull requests are welcome! If you'd like to suggest improvements, feel free to open an issue or PR.

🙋‍♂️ Author
Tarun Yadav
GitHub · LinkedIn

About

A React-based donation wishlist platform for NGOs and orphanages to list needs and connect with donors in real-time.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors