{"id":25121325,"url":"https://github.com/maksudulhaque2000/Winter-Clothing-Donation","last_synced_at":"2025-10-23T02:31:18.365Z","repository":{"id":275924405,"uuid":"927596291","full_name":"smmaksudulhaque2000/Winter-Clothing-Donation","owner":"smmaksudulhaque2000","description":"The Winter Clothing Donation platform connects donors with volunteers to provide winter clothing to people in need across Bangladesh. It ensures that vulnerable communities, especially in rural and low-income areas, receive essential clothing during the cold season.","archived":false,"fork":false,"pushed_at":"2025-02-05T09:32:41.000Z","size":5324,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T10:33:36.694Z","etag":null,"topics":["eslint","firebase","js","reactjs","tailwindcss","vite"],"latest_commit_sha":null,"homepage":"https://winter-clothing-donation-e20cd.web.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smmaksudulhaque2000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-05T08:12:56.000Z","updated_at":"2025-02-05T09:32:45.000Z","dependencies_parsed_at":"2025-02-05T10:43:50.705Z","dependency_job_id":null,"html_url":"https://github.com/smmaksudulhaque2000/Winter-Clothing-Donation","commit_stats":null,"previous_names":["smmaksudulhaque2000/winter-clothing-donation"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smmaksudulhaque2000%2FWinter-Clothing-Donation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smmaksudulhaque2000%2FWinter-Clothing-Donation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smmaksudulhaque2000%2FWinter-Clothing-Donation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smmaksudulhaque2000%2FWinter-Clothing-Donation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smmaksudulhaque2000","download_url":"https://codeload.github.com/smmaksudulhaque2000/Winter-Clothing-Donation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237764066,"owners_count":19362345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eslint","firebase","js","reactjs","tailwindcss","vite"],"created_at":"2025-02-08T06:17:48.297Z","updated_at":"2025-10-23T02:31:17.665Z","avatar_url":"https://github.com/smmaksudulhaque2000.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://i.ibb.co.com/MD4xvD1w/Screenshot-2.png\" height=\"400\" width=\"800\" alt=\"Winter-Clothing-Donation\"/\u003e\n\u003c/div\u003e\n\n# Winter Clothing Donation\n\n## 📌 Introduction\n\nThe **Winter Clothing Donation** web application is designed to facilitate the donation of winter clothing to people in need across Bangladesh. The platform seamlessly connects donors with volunteers, ensuring that vulnerable communities, especially in rural and low-income areas, receive essential winter clothing during the cold season.\n\n## 🌐 Live Demo\n\n[Winter Clothing Donation - Live](https://winter-clothing-donation-e20cd.web.app/)\n\n---\n\n## 📖 Table of Contents\n\n- [Introduction](#-introduction)\n- [Live Demo](#-live-demo)\n- [Key Features](#-key-features)\n- [Technology Stack](#-technology-stack)\n- [Installation Guide](#-installation-guide)\n- [Pages \u0026 Components](#-pages-and-components)\n- [Challenges Implemented](#-challenges-implemented)\n- [Future Enhancements](#-future-enhancements)\n- [Contact Information](#-contact-information)\n- [License](#-license)\n\n---\n\n## 🚀 Key Features\n\n✅ **User Authentication** – Register, log in, and manage user profiles.  \n✅ **Donation Campaigns** – Browse and contribute to various winter clothing campaigns across Bangladesh.  \n✅ **Donation Form** – Submit donation details, including items and pickup location.  \n✅ **Responsive Design** – Mobile-friendly, tablet, and desktop-compatible UI.  \n✅ **Firebase Integration** – Firebase Authentication and Firestore database.  \n✅ **Toast Notifications** – Real-time confirmation messages on successful donations.  \n\n---\n\n## 🛠️ Technology Stack\n\n### **Frontend**  \n- React.js  \n- CSS (for custom styling)  \n- Firebase Authentication  \n- Firebase Firestore  \n\n### **Libraries \u0026 Packages Used**  \n- `react-router-dom` – Routing  \n- `firebase` – Authentication and backend integration  \n- `react-toastify` – Toast notifications  \n- `swiper` – Image sliders  \n- `daisyUI` – UI components  \n- `AOS` (Animate On Scroll) – Smooth animations  \n\n### **Hosting**  \n- Firebase Hosting  \n\n---\n\n## 🏗️ Installation Guide\n\nFollow these steps to set up the project locally:  \n\n### **1️⃣ Clone the Repository**  \n```bash\ngit clone https://github.com/your-username/winter-clothing-donation.git\n```\nReplace `your-username` with your actual GitHub username.  \n\n### **2️⃣ Navigate to the Project Directory**  \n```bash\ncd winter-clothing-donation\n```\n\n### **3️⃣ Install Dependencies**  \n```bash\nnpm install\n```\n\n### **4️⃣ Configure Firebase**  \n- Go to [Firebase Console](https://console.firebase.google.com/) and create a project.  \n- Enable Firebase Authentication and Firestore.  \n- Add the Firebase configuration keys in a `.env` file in the root directory:  \n\n```bash\nREACT_APP_FIREBASE_API_KEY=your-api-key\nREACT_APP_FIREBASE_AUTH_DOMAIN=your-auth-domain\nREACT_APP_FIREBASE_PROJECT_ID=your-project-id\nREACT_APP_FIREBASE_STORAGE_BUCKET=your-storage-bucket\nREACT_APP_FIREBASE_MESSAGING_SENDER_ID=your-messaging-sender-id\nREACT_APP_FIREBASE_APP_ID=your-app-id\n```\n\n### **5️⃣ Start the Development Server**  \n```bash\nnpm start\n```\n\n### **6️⃣ Open in Browser**  \nGo to `http://localhost:3000` to see the application in action.  \n\n---\n\n## 📌 Pages and Components\n\n### **🔹 Home Page**  \n- Includes a banner, an about section, and donation instructions.  \n\n### **🔹 Donation Campaigns**  \n- Displays all available campaigns for winter clothing donations.  \n\n### **🔹 Donation Details Page**  \n- A private page for logged-in users to submit donation details.  \n\n### **🔹 Dashboard**  \n- Displays user profile information and allows updates.  \n\n### **🔹 Login / Registration**  \n- Supports email/password sign-in and Google authentication.  \n\n### **🔹 Error Page**  \n- Displays a custom 404 error page for invalid routes.  \n\n---\n\n## 🔥 Challenges Implemented\n\n🔹 **Password Toggling** – Show/hide password feature during user registration.  \n🔹 **Forgot Password** – Users can reset their passwords securely.  \n🔹 **Profile Update** – Users can update their name and profile picture.  \n🔹 **Smooth Animations** – Implemented `AOS` for seamless animations.  \n\n---\n\n## 📈 Future Enhancements\n\n🚀 **Email verification after registration**  \n🚀 **A detailed donation tracking system**  \n🚀 **Campaign progress tracking for better user experience**  \n\n---\n\n## 📩 Contact Information\n\nIf you have any questions or suggestions, feel free to reach out.  \n\n📌 **Social Media:**  \n- [Linkedin](https://www.linkedin.com/in/maksudulhaque2000/)\n- [Facebook](https://www.facebook.com/maksudulhaque2000)\n- [Twitter](https://x.com/i/flow/login?redirect_after_login=%2Fsmmaksudulhaque)\n- [Youtube](https://www.youtube.com/@smmaksudulhaque)\n\n---\n\n## ©️ Copyright\n\n© **Winter Clothing Donation Website**, 2024. All rights reserved.  \n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT License**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksudulhaque2000%2FWinter-Clothing-Donation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaksudulhaque2000%2FWinter-Clothing-Donation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksudulhaque2000%2FWinter-Clothing-Donation/lists"}