{"id":29013221,"url":"https://github.com/apolo-itnet/losttrace-client","last_synced_at":"2026-04-11T17:05:08.379Z","repository":{"id":301152395,"uuid":"1008316014","full_name":"apolo-itnet/LostTrace-Client","owner":"apolo-itnet","description":" Lost Trace is a full-stack Lost \u0026 Found web application where users can report, search, and recover lost or found items. It offers secure authentication, protected routes, recovery workflow, and real-time feedback through a responsive modern UI.","archived":false,"fork":false,"pushed_at":"2025-08-09T03:39:24.000Z","size":228,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-09T05:33:13.297Z","etag":null,"topics":["axios-react","expressjs","firebase-auth","framer-motion","mongodb","nodejs","react-router","reactjs","tailwindcss"],"latest_commit_sha":null,"homepage":"https://lost-trace.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/apolo-itnet.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,"zenodo":null}},"created_at":"2025-06-25T11:02:54.000Z","updated_at":"2025-08-09T03:39:27.000Z","dependencies_parsed_at":"2025-08-09T05:24:55.966Z","dependency_job_id":"d59dc8e9-6171-455a-9fbc-ef5ab194b6cf","html_url":"https://github.com/apolo-itnet/LostTrace-Client","commit_stats":null,"previous_names":["apolo-itnet/losttrace-client"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/apolo-itnet/LostTrace-Client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apolo-itnet%2FLostTrace-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apolo-itnet%2FLostTrace-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apolo-itnet%2FLostTrace-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apolo-itnet%2FLostTrace-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apolo-itnet","download_url":"https://codeload.github.com/apolo-itnet/LostTrace-Client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apolo-itnet%2FLostTrace-Client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280879004,"owners_count":26406773,"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","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["axios-react","expressjs","firebase-auth","framer-motion","mongodb","nodejs","react-router","reactjs","tailwindcss"],"created_at":"2025-06-25T19:10:27.328Z","updated_at":"2025-10-24T23:14:17.305Z","avatar_url":"https://github.com/apolo-itnet.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 LOST \u0026 TRACE – Lost and Found Item Tracker\n\nLOST \u0026 TRACE is a full-stack web application that connects people who have lost something with those who’ve found items. It’s built to streamline the process of recovering lost belongings through a simple and secure platform.\n\n---\n## 🌐 Live Links\n🔗 **Live Website**: https://lost-trace.web.app  \u003cbr\u003e\n🔗 **Client GitHub**: https://github.com/apolo-itnet/LostTrace-Client \u003cbr\u003e\n🔗 **Server GitHub**: https://github.com/apolo-itnet/LostTrace-Server\n\n\n---\n\n## 🧪 How to Run Locally\n\n\u003e Prerequisites: Node.js, MongoDB, npm/yarn\n\n### 1. Clone the Client\n\n```bash\ngit clone https://github.com/your-username/lost-trace-client.git\ncd lost-trace-client\nnpm install\nnpm run dev\n```\n### 2. Clone the Server\n```\ngit clone https://github.com/your-username/lost-trace-server.git\ncd lost-trace-server\nnpm install\nnpm start\n```\n\n### 3. Environment Variables\n**Client .env**\n\n```\nVITE_API_URL=http://localhost:5000\nVITE_FIREBASE_API_KEY=your_firebase_key\nVITE_FIREBASE_AUTH_DOMAIN=your_app.firebaseapp.com\nVITE_FIREBASE_PROJECT_ID=your_project_id\nVITE_FIREBASE_APP_ID=your_app_id\n```\n\n**Server .env**\n```\nPORT=5000\nMONGODB_URI=mongodb+srv://\u003cuser\u003e:\u003cpass\u003e@cluster.mongodb.net/losttraceDB\nJWT_SECRET=your_secret_key\n```\n\n\n## 🛠 Tech Stack\n\n### Frontend:\n- React.js\n- Tailwind CSS + DaisyUI\n- React Router\n- AOS, Framer Motion\n- React Icons, SweetAlert2, React Toastify\n- Firebase Authentication\n- Vite, Netlify Hosting\n\n### Backend:\n- Node.js, Express.js\n- MongoDB (Mongoose)\n- JWT \u0026 Cookie Authentication\n- Dotenv, CORS, Helmet\n- Vercel Hosting\n\n---\n\n## 🎯 Project Purpose\n\nThe goal of this project is to provide a user-friendly platform for reporting and finding lost items. It includes authentication, protected routes, CRUD functionality, and real-time updates, offering a complete MERN stack experience.\n\n---\n\n## 💡 Key Features\n\n- 🔐 **Firebase Authentication** (Email/Password \u0026 Google Login)\n- 🧠 **JWT Authorization** for private route protection\n- 📄 **Dynamic Page Titles** per route\n- 🌐 **Fully Responsive** for mobile, tablet, and desktop\n- 💬 **Toast \u0026 SweetAlert** notifications\n- 🗂️ **Lost \u0026 Found Item Categorization**\n- 🎨 **Framer Motion Animations**\n- 🔍 **Search Functionality** on All Items page\n- ✏️ **Item Update \u0026 Delete** with confirmation modal\n- 📊 **View Items in Card/Table Layout Toggle**\n\n---\n\n## 🧰 Technologies \u0026 Packages Used\n\n### ⚛️ Frontend (React + Vite + Tailwind CSS)\n- `React Router`\n- `Firebase`\n- `Framer Motion`\n- `React DatePicker`\n- `Axios`\n- `React Icons`\n- `AOS`\n- `SwiperJS`\n- `SweetAlert2`\n- `Tailwind CSS` + `DaisyUI`\n\n### 🖥️ Backend (Node.js + Express + MongoDB)\n- `Cors`\n- `JWT`\n- `Dotenv`\n- `MongoDB`\n- `Express.js`\n\n---\n\n### 🧑‍💻 Pages \u0026 Routes\n| Route                     | Description                        | Protected |\n| ------------------------- | ---------------------------------- | --------- |\n| `/`                       | Home page                          | ❌         |\n| `/login`, `/register`     | Auth pages                         | ❌         |\n| `/add-lost`, `/add-found` | Add item                           | ✅         |\n| `/my-posts`               | View/manage your listings          | ✅         |\n| `/details/:id`            | Post detail view with claim option | ✅         |\n| `/feedback`               | Submit feedback                    | ✅         |\n\n---\n\n### 🧾 CRUD Functionalities\n- ✅ Create: Add new lost/found posts\n- ✅ Read: View all posts \u0026 details\n- ✅ Update: Edit your own listings\n- ✅ Delete: Remove your item posts\n\n---\n\n### 🛡️ Security\n\n- 🔐 **Firebase \u0026 MongoDB credentials secured** via `.env` variables.\n- 📜 **JWT token** used to protect private routes and validate user identity.\n\n---\n\n## 🚀 Deployment\n\n- ✅ Live hosted on **Vercel / Netlify** (Client) and **Render / Cyclic** (Server)\n- 🛠️ Server \u0026 Client error-handled (No 404, 504, CORS errors)\n- ⚠️ Private routes persist login on reload\n- 🔐 Firebase domain authorized for the production domain\n\n---\n\n## ✅ Bonus Features\n\n- ✅ Dynamic layout toggle on `/allRecovered`\n- ✅ Extra Feature: Feedback System / Rating Component\n- ✅ UI Enhanced with Framer Motion, AOS, and Tailwind Utilities\n\n---\n\n## 📸 Screenshots\n\n\u003e Include screenshots here if needed  \n\u003e ![Home Page](screenshot-url)  \n\u003e ![Add Item Form](screenshot-url)  \n\u003e ![Details Modal](screenshot-url)\n\n---\n\n### 💡 Inspiration\n\"Lost Trace\" was inspired by the everyday need for a digital Lost \u0026 Found system. \u003cbr\u003e\nWhether someone loses a wallet, mobile, or pet — this platform aims to connect honest finders with those desperately looking for what they lost.\n\n---\n\n### 📬 Submission\nThis project was submitted as Assignment-11 in the MERN Stack Developer Program.\n\n---\n\n### 👨‍💻 Developer Info\n**Apolo Barua Apurbo**   \u003cbr\u003e \n💼 MERN Stack Web Developer  \u003cbr\u003e \n📧 **Email**: apolo.itnet@gmail.com  \u003cbr\u003e \n📍 **Location**: Bangladesh  \u003cbr\u003e \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapolo-itnet%2Flosttrace-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapolo-itnet%2Flosttrace-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapolo-itnet%2Flosttrace-client/lists"}