{"id":25495445,"url":"https://github.com/raufurislam/foundify","last_synced_at":"2026-04-15T10:37:31.154Z","repository":{"id":275967839,"uuid":"927552536","full_name":"raufurislam/foundify","owner":"raufurislam","description":"A comprehensive platform designed to assist users in reporting and recovering lost items, as well as finding and returning found items. The application offers user authentication, a robust database for item records, and a responsive, intuitive interface to facilitate ease of use.","archived":false,"fork":false,"pushed_at":"2025-03-12T17:27:25.000Z","size":354,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-19T09:11:43.744Z","etag":null,"topics":["expres","firebase","javascript","mongodb","nodejs","reactjs","tailwindcss"],"latest_commit_sha":null,"homepage":"https://foundify-raufur-a11.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/raufurislam.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-02-05T06:28:20.000Z","updated_at":"2025-03-12T17:27:29.000Z","dependencies_parsed_at":"2025-02-05T15:33:27.389Z","dependency_job_id":"cc811fdc-7343-4b6e-b97e-59b156045445","html_url":"https://github.com/raufurislam/foundify","commit_stats":null,"previous_names":["raufurislam/foundify"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/raufurislam/foundify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raufurislam%2Ffoundify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raufurislam%2Ffoundify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raufurislam%2Ffoundify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raufurislam%2Ffoundify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raufurislam","download_url":"https://codeload.github.com/raufurislam/foundify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raufurislam%2Ffoundify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31837696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T10:26:52.245Z","status":"ssl_error","status_checked_at":"2026-04-15T10:26:51.649Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["expres","firebase","javascript","mongodb","nodejs","reactjs","tailwindcss"],"created_at":"2025-02-19T00:36:45.012Z","updated_at":"2026-04-15T10:37:31.125Z","avatar_url":"https://github.com/raufurislam.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://i.ibb.co.com/H46zND8/foundify-05.png\" alt=\"Crowdcube Icon\" width=\"28\" height=\"28\"\u003e Foundify\n\n\u003cdiv align=\"center\" style=\"width: 100%; height: 580px; overflow: hidden; border-radius: 10px;\"\u003e\n  \u003cimg src=\"https://i.ibb.co/pBJXRSrD/soulmate.jpg\" alt=\"Foundify Banner\" style=\"width: 100%; height: 100%; object-fit: cover;\" /\u003e\n\u003c/div\u003e\n\nA comprehensive platform designed to assist users in reporting and recovering lost items, as well as finding and returning found items. The application offers user authentication, a robust database for item records, and a responsive, intuitive interface to facilitate ease of use.\n\n## 🚀 **Live Demo**\n\nCheck out the live site: [https://foundify-raufur-a11.web.app](https://foundify-raufur-a11.web.app/)\n\n## Purpose\n\nThe purpose of this project is to create a centralized platform where users can:\n\n- Report items they have lost.\n- Report items they have found.\n- Search for lost or found items based on category or location.\n- Recover their belongings with ease through detailed recovery actions.\n\n## Key Features\n\n- **Authentication:** Secure login and registration using email/password or third-party providers (Google/GitHub).\n- **Dynamic Home Page:**\n  - Attractive slider/banner with transitions.\n  - Latest lost/found items section.\n  - Additional meaningful sections with animations.\n- **Add Lost/Found Items:** User-friendly forms to report items with detailed descriptions and images.\n- **Search and Filter:** Advanced filtering options for lost and found items.\n- **Post Management:** Users can update or delete their posts directly from a dedicated dashboard.\n- **Recovered Items:** A separate page showcasing all recovered items with multiple view options.\n- **Animations:** Interactive transitions using Framer Motion.\n- **Responsive Design:** Optimized for all devices.\n\n## Technology Stack\n\n- **Frontend:** React, Tailwind CSS, DaisyUI, Framer Motion\n- **Backend:** Node.js, Express.js\n- **Database:** MongoDB\n- **Authentication:** Firebase Authentication\n- **Deployment:** Vercel (Frontend), Render (Backend)\n\n## NPM Packages Used\n\n- **React Router DOM:** For seamless navigation between pages.\n- **Framer Motion:** For animations.\n- **React Icons:** To add visually appealing icons.\n- **SweetAlert2:** For elegant alert dialogs.\n- **Axios:** For HTTP requests.\n- **Dotenv:** For environment variable management.\n- **Cors:** To handle cross-origin requests.\n- **Body-Parser:** For parsing incoming request bodies.\n\n## Dependencies\n\n### Frontend:\n\n- **React**: A JavaScript library for building user interfaces.\n- **Tailwind CSS**: A utility-first CSS framework for designing responsive layouts.\n- **DaisyUI**: A Tailwind CSS plugin for UI components.\n- **Framer Motion**: A library for animations and interactive transitions.\n- **React Router DOM**: A routing library for seamless navigation between pages.\n- **React Icons**: A library to include icons in your React app.\n- **SweetAlert2**: For elegant and customizable alert dialogs.\n- **Axios**: A promise-based HTTP client for making requests.\n\n### Backend:\n\n- **Node.js**: JavaScript runtime environment.\n- **Express.js**: Web framework for Node.js to build server-side applications.\n- **MongoDB**: A NoSQL database for storing application data.\n- **Firebase Authentication**: For user authentication (email/password and third-party providers like Google and GitHub).\n\n### Development Tools:\n\n- **Dotenv**: Loads environment variables from a `.env` file.\n- **Cors**: A package to handle cross-origin resource sharing.\n- **Body-Parser**: Middleware to parse incoming request bodies.\n\n## How to Run Locally\n\n1. Clone the repository:\n   ```bash\n   git clone \u003crepository-url\u003e\n   ```\n2. Navigate to the project directory:\n   ```bash\n   cd whereisit\n   ```\n3. Install dependencies for both client and server:\n   ```bash\n   cd client\n   npm install\n   cd ../server\n   npm install\n   ```\n4. Add environment variables for Firebase and MongoDB in `.env` files for both client and server.\n5. Run the client and server:\n   ```bash\n   cd client\n   npm start\n   cd ../server\n   npm run start\n   ```\n6. Open `http://localhost:3000` in your browser to access the application.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request or open an issue to discuss changes.\n\n---\n\nThank you for checking out **WhereIsIt**! We hope this platform makes it easier for people to recover their lost items.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraufurislam%2Ffoundify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraufurislam%2Ffoundify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraufurislam%2Ffoundify/lists"}