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.
- 🎯 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
- React.js (Frontend library)
- Material UI (UI components and styling)
- JavaScript (Functional logic)
- HTML5 + CSS3 (Structure & layout)
- Optional: Firebase/Node.js (for backend integration)
(Add screenshots of homepage, NGO cards, item list, etc. here)
You can use tools likeLightshot,Snipping Tool, orVercel Previewfor this.
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