{"id":28572472,"url":"https://github.com/maksudulhaque2000/wherelist","last_synced_at":"2026-04-02T04:46:00.061Z","repository":{"id":285650003,"uuid":"927616359","full_name":"maksudulhaque2000/Wherelist","owner":"maksudulhaque2000","description":"WhereIsIt (Client Side) is the user interface for the Lost and Found platform, allowing users to report lost or found items, manage submissions, and interact easily with the platform. It is designed to be user-friendly, intuitive, and fully responsive.","archived":false,"fork":false,"pushed_at":"2025-02-05T08:59:23.000Z","size":6262,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-10T20:54:24.544Z","etag":null,"topics":["daisyui","eslint","express","firebase","mongodb","reactjs","tailwindcss","vercel","vite"],"latest_commit_sha":null,"homepage":"https://whereisit-4b5c6.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/maksudulhaque2000.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:56:29.000Z","updated_at":"2025-02-05T09:02:18.000Z","dependencies_parsed_at":"2025-04-01T23:34:40.627Z","dependency_job_id":"e6e20ea9-7c27-44a4-a987-9c88affd926c","html_url":"https://github.com/maksudulhaque2000/Wherelist","commit_stats":null,"previous_names":["maksudulhaque2000/wherelist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maksudulhaque2000/Wherelist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maksudulhaque2000%2FWherelist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maksudulhaque2000%2FWherelist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maksudulhaque2000%2FWherelist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maksudulhaque2000%2FWherelist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maksudulhaque2000","download_url":"https://codeload.github.com/maksudulhaque2000/Wherelist/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maksudulhaque2000%2FWherelist/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261422631,"owners_count":23156035,"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":["daisyui","eslint","express","firebase","mongodb","reactjs","tailwindcss","vercel","vite"],"created_at":"2025-06-10T20:37:30.072Z","updated_at":"2025-12-30T19:57:06.660Z","avatar_url":"https://github.com/maksudulhaque2000.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://i.ibb.co.com/QFYHkjW4/Screenshot-4.png\" height=\"400\" width=\"800\" alt=\"Wherelist\"/\u003e\n\u003c/div\u003e\n\n# 🔍 WhereIsIt - Client Side\n\n## 📌 Project Purpose\n\n**WhereIsIt** (Client Side) serves as the user interface for the Lost and Found platform. It enables users to report lost or found items, manage submissions, and interact seamlessly with the platform. The client-side is designed to be user-friendly, intuitive, and responsive.\n\n## 🌍 Live Demo\n\n🔗 [Visit WhereIsIt Live Website](https://whereisit-4b5c6.web.app/)\n\n---\n\n## 🚀 Key Features\n\n✅ **Fully Responsive Design** – Optimized for all screen sizes.  \n✅ **Authentication** – Secure email/password login with Google authentication.  \n✅ **Lost \u0026 Found Management** – Users can add, update, and delete posts.  \n✅ **Search \u0026 Filter** – Find items based on title or location.  \n✅ **Framer Motion Animations** – Smooth and engaging UI animations.  \n✅ **Dynamic Title Updates** – Reflects the current page in the browser tab.  \n✅ **Toast Notifications** – User-friendly alerts for important actions.  \n✅ **Protected Routes** – Only logged-in users can manage their items.  \n\n### 🏠 Home Page Features\n\n1. **Home Section** – Displays a slider and recent lost \u0026 found posts.  \n2. **Lost \u0026 Found Items** – View and search for all lost and found items.  \n3. **Add New Item** – Private route for adding new posts.  \n4. **Manage My Items** – Users can edit or delete their submissions.  \n5. **All Recovered Items** – View items that have been successfully returned.  \n\n---\n\n## 🛠️ Technologies Used\n\n- **Frontend**: React.js, React Router  \n- **UI \u0026 Styling**: TailwindCSS, Framer Motion, React Datepicker  \n- **Authentication**: Firebase Authentication  \n- **Data Management**: Axios, SweetAlert2  \n\n---\n\n## 🔧 Setup Instructions\n\n### **Prerequisites**\n\n- Install **Node.js** (v14 or later).\n\n### **1️⃣ Clone the Repository**  \n```bash\ngit clone https://github.com/your-username/whereisit-client.git\n```\n\n### **2️⃣ Navigate to the Project Directory**  \n```bash\ncd whereisit-client\n```\n\n### **3️⃣ Install Dependencies**  \n```bash\nnpm install\n```\n\n### **4️⃣ Configure Environment Variables**  \nCreate a `.env` file and add:  \n```env\nREACT_APP_FIREBASE_API_KEY=your_firebase_api_key\nREACT_APP_FIREBASE_AUTH_DOMAIN=your_firebase_auth_domain\nREACT_APP_FIREBASE_PROJECT_ID=your_project_id\n```\n\n### **5️⃣ Start the Development Server**  \n```bash\nnpm start\n```\n\n---\n\n## 📝 Meaningful Commits\n\n1. Initial Setup  \n2. Added Footer Component  \n3. Implemented Lost \u0026 Found Items Page  \n4. Connected Details Page to Backend  \n5. Created \"My Items\" Management Page  \n6. Added Status Update Feature  \n7. Integrated Framer Motion for Animations  \n8. Deployed Project to Firebase  \n\n---\n\n## 🙌 Acknowledgments\n\nSpecial thanks to the **WhereIsIt** team for the opportunity to contribute to this project.  \n\n---\n\n# 🛠️ WhereIsIt - Server Side\n\n## 📌 Project Purpose\n\nWhereIsIt (Server Side) is the backend for the Lost and Found platform. It securely handles user authentication, item management, and data storage, supporting the client-side functionalities.\n\n## 🌍 Live Server\n\n🔗 [Visit WhereIsIt Live Server](https://where-is-it-server.vercel.app/)\n\n---\n\n## 🚀 Key Features\n\n✅ **RESTful API Endpoints** – CRUD operations for lost and found items.  \n✅ **MongoDB Integration** – Secure and scalable NoSQL database.  \n✅ **JWT Authentication** – Secure access for private routes.  \n✅ **Environment Variable Security** – Sensitive credentials are stored securely.  \n✅ **CORS Enabled** – Allows safe cross-origin requests.  \n✅ **Comprehensive Error Handling** – Provides clear API responses.  \n\n### 🛠️ Core Functionalities\n\n- **User Authentication** – Secure JWT-based authentication system.  \n- **Item Management** – CRUD operations for lost \u0026 found items.  \n- **Database Integration** – MongoDB stores user \u0026 item data.  \n- **Search \u0026 Filter** – Efficient filtering of items.  \n- **Secure API Requests** – CORS enabled with validation \u0026 authorization.  \n\n---\n\n## 🛠️ Technologies Used\n\n- **Backend**: Node.js, Express.js  \n- **Database**: MongoDB, Mongoose  \n- **Security**: JWT Authentication, dotenv  \n- **Deployment**: Vercel  \n\n---\n\n## 🔧 Setup Instructions\n\n### **Prerequisites**\n\n- Install **Node.js**  \n- Set up a **MongoDB Atlas** database or local MongoDB instance.\n\n### **1️⃣ Clone the Repository**  \n```bash\ngit clone https://github.com/your-username/whereisit-server.git\n```\n\n### **2️⃣ Navigate to the Project Directory**  \n```bash\ncd whereisit-server\n```\n\n### **3️⃣ Install Dependencies**  \n```bash\nnpm install\n```\n\n### **4️⃣ Configure Environment Variables**  \nCreate a `.env` file and add:  \n```env\nPORT=5000\nMONGO_URI=your_mongodb_connection_string\nJWT_SECRET=your_jwt_secret\n\nFIREBASE_API_KEY=your_firebase_api_key\nFIREBASE_AUTH_DOMAIN=your_firebase_auth_domain\nFIREBASE_PROJECT_ID=your_firebase_project_id\nFIREBASE_STORAGE_BUCKET=your_firebase_storage_bucket\nFIREBASE_MESSAGING_SENDER_ID=your_firebase_messaging_sender_id\nFIREBASE_APP_ID=your_firebase_app_id\n```\n\n### **5️⃣ Start the Server**  \n```bash\nnpm start\n```\n\n---\n\n## 🔗 API Endpoints\n\n- **POST /api/items** – Add a new lost/found item.  \n- **GET /api/items** – Retrieve all lost \u0026 found items.  \n- **GET /api/items/:id** – Retrieve a specific item by ID.  \n- **PUT /api/items/:id** – Update an item’s details.  \n- **DELETE /api/items/:id** – Remove an item from the database.  \n- **POST /api/recovered** – Mark an item as recovered.  \n\n---\n\n## 📝 Meaningful Commits\n\n1. Initial Server Setup  \n2. Integrated MongoDB \u0026 Connected API Routes  \n3. Implemented JWT Authentication  \n4. Developed CRUD Operations for Items  \n5. Added Secure Environment Variables  \n6. Optimized API Performance  \n7. Enabled CORS for Cross-Origin Access  \n8. Deployed Server to Vercel  \n\n---\n\n## 🙌 Acknowledgments\n\nSpecial thanks to the **WhereIsIt** team for providing a platform to work on this meaningful project.  \n\n---\n\n## 📜 License\n\nDistributed under the **MIT License**. See `LICENSE` for details.  \n\n---\n\n🎉 **Happy Coding!** 🚀  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksudulhaque2000%2Fwherelist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaksudulhaque2000%2Fwherelist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksudulhaque2000%2Fwherelist/lists"}