{"id":28149953,"url":"https://github.com/hossainshofiq/perfectalt-client","last_synced_at":"2026-04-12T15:10:14.590Z","repository":{"id":289544125,"uuid":"937347109","full_name":"hossainshofiq/PerfectAlt-Client","owner":"hossainshofiq","description":"The Product Recommendation Platform lets users add, manage, and view product queries and recommendations. With secure JWT authentication, allowing users to interact with queries, share recommendations, and see suggestions. The platform is built with MongoDB, Firebase, and dynamic UI components.","archived":false,"fork":false,"pushed_at":"2025-04-24T20:09:19.000Z","size":7967,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T02:14:57.969Z","etag":null,"topics":["expressjs","firebase","jwt","mongodb","nodejs","react"],"latest_commit_sha":null,"homepage":"https://product-recommendation-s-d6b6d.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/hossainshofiq.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-22T21:21:55.000Z","updated_at":"2025-04-24T20:09:23.000Z","dependencies_parsed_at":"2025-04-23T20:38:30.763Z","dependency_job_id":"a3699a8a-3762-416a-9cf9-b113c9d01c41","html_url":"https://github.com/hossainshofiq/PerfectAlt-Client","commit_stats":null,"previous_names":["hossainshofiq/perfectalt-client"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hossainshofiq/PerfectAlt-Client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossainshofiq%2FPerfectAlt-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossainshofiq%2FPerfectAlt-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossainshofiq%2FPerfectAlt-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossainshofiq%2FPerfectAlt-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hossainshofiq","download_url":"https://codeload.github.com/hossainshofiq/PerfectAlt-Client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossainshofiq%2FPerfectAlt-Client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008837,"owners_count":26084517,"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-11T02:00:06.511Z","response_time":55,"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":["expressjs","firebase","jwt","mongodb","nodejs","react"],"created_at":"2025-05-15T02:14:58.345Z","updated_at":"2025-10-11T21:41:11.247Z","avatar_url":"https://github.com/hossainshofiq.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 **PerfectAlt**  \n\n**Live Site URL:**  \n[🔗 PerfectAlt](https://product-recommendation-s-d6b6d.web.app/)\n\n## 📞 **Contact Information**  \n📱 **Phone Number:** +8801689819951  \n\n---\n\n## 📌 **Project Overview**  \n**PerfectAlt** is a full-stack **Product Recommendation Platform** that enables users to:  \n\n✔️ **Add, manage, and view product queries and recommendations**  \n✔️ **Securely authenticate with Firebase (Google login)**  \n✔️ **Ensure protected access using JWT authentication**  \n✔️ **Experience a fully responsive UI with engaging animations**  \n✔️ **Explore Recent products, featured products, highlighted brands, trending categories, FAQs, and reviews**  \n\n![PerfectAlt Screenshot](src/assets/banner_secreenshot2.jpg)  \n\n---\n\n## 📚 **Table of Contents**  \n- [Technology Stack](#-technology-stack)  \n- [Features](#-features)  \n- [Installation](#-installation)  \n- [Dependencies](#-dependencies)  \n- [NPM Packages Used](#-npm-packages-used)  \n- [Design Inspiration](#-design-inspiration)  \n\n---\n\n## 🛠 **Technology Stack**  \n\n### **Frontend (Client-Side)**  \n- ⚛️ **React.js** – Component-based frontend framework  \n- 🎨 **Tailwind CSS** – Styling and responsive design  \n\n### **Backend (Server-Side)**  \n- ⚡ **Node.js** – JavaScript runtime for the server  \n- 🌐 **Express.js** – Web framework for building APIs  \n- 🗄 **MongoDB** – NoSQL database for data storage  \n\n### **Authentication \u0026 Security**  \n- 🔑 **Firebase Authentication** – Secure login via Google/GitHub  \n- 🔒 **JWT \u0026 Middleware** – Ensuring protected API access  \n\n---\n\n## ✨ **Features**  \n\n### 🔐 **Authentication**  \n✔️ Email/Password login  \n✔️ Google Sign-in  \n✔️ JWT-based private route protection  \n\n### 📝 **Queries**  \n✔️ Add, view, update, and delete queries  \n✔️ Search functionality based on product names  \n\n### 📢 **Recommendations**  \n✔️ Add, view, and delete recommendations  \n✔️ Dynamic recommendation count updates  \n\n### 📱 **Responsive Design**  \n✔️ Fully responsive across **mobile, tablet, and desktop** \n\n### 🚀 **Homepage Highlights**  \n✔️ Animated hero/slider section  \n✔️ All queries overview  \n✔️ Featured products display  \n✔️ Highlighted brands section  \n✔️ Trending categories section  \n✔️ FAQs and customer reviews  \n\n### 🚀 **Navigation**  \n✔️ Conditional Navbar rendering based on authentication  \n\n### 🔍 **Additional Features**  \n✔️ **404 Error Page** – Redirects users to the homepage  \n✔️ **Recent Queries Section** – Interactive slider for latest queries  \n✔️ **Animations** – Enhanced UI with creative homepage sections  \n✔️ **UI Alerts** – SweetAlert2 for UI alerts and feedback\n\n---\n\n## 🛠 **Installation**  \n\n### **Clone the repository**  \n```bash\ngit clone https://github.com/your-username/your-repo.git\ncd your-repo\n```\n\n### **Install dependencies**  \n```bash\nnpm install\n```\n\n### **Start the development server**  \n```bash\nnpm run dev\n```\n\n---\n\n## 📦 **Dependencies**  \n\n### **Main Dependencies**  \n```json\n{\n  \"axios\": \"^1.7.9\",\n  \"firebase\": \"^11.1.0\",\n  \"localforage\": \"^1.10.0\",\n  \"lottie-react\": \"^2.4.0\",\n  \"match-sorter\": \"^8.0.0\",\n  \"motion\": \"^11.15.0\",\n  \"react\": \"^18.3.1\",\n  \"react-dom\": \"^18.3.1\",\n  \"react-icons\": \"^5.4.0\",\n  \"react-router-dom\": \"^7.1.0\",\n  \"react-tooltip\": \"^5.28.0\",\n  \"sort-by\": \"^1.2.0\",\n  \"sweetalert2\": \"^11.15.3\",\n  \"swiper\": \"^11.1.15\"\n}\n```\n\n### **Development Dependencies**  \n```json\n{\n  \"@eslint/js\": \"^9.17.0\",\n  \"@types/react\": \"^18.3.17\",\n  \"@types/react-dom\": \"^18.3.5\",\n  \"@vitejs/plugin-react\": \"^4.3.4\",\n  \"autoprefixer\": \"^10.4.20\",\n  \"daisyui\": \"^4.12.22\",\n  \"eslint\": \"^9.17.0\",\n  \"eslint-plugin-react\": \"^7.37.2\",\n  \"eslint-plugin-react-hooks\": \"^5.0.0\",\n  \"eslint-plugin-react-refresh\": \"^0.4.16\",\n  \"globals\": \"^15.13.0\",\n  \"postcss\": \"^8.4.49\",\n  \"tailwindcss\": \"^3.4.17\",\n  \"vite\": \"^6.0.3\"\n}\n```\n\n---\n\n## 📦 **NPM Packages Used**  \n\n### **Frontend**  \n✔️ `react` – Component-based user interface development  \n✔️ `react-router-dom` – Routing and navigation  \n✔️ `react-icons` – Icon library  \n✔️ `axios` – HTTP requests to the server  \n✔️ `lottie-react` – For animated sections  \n✔️ `react-tooltip` – Tooltip functionalities  \n\n### **Backend**  \n✔️ `express` – Web server framework  \n✔️ `mongoose` – MongoDB object modeling  \n✔️ `dotenv` – Environment variable management  \n✔️ `jsonwebtoken` – JWT token creation and validation  \n✔️ `cors` – Enable CORS policies  \n\n---\n\n## 🔐 **User Credentials**\n✔️ **Email** : shofiq@gmail.com\n✔️ **Password** : Shofiq\n\n---\n\n## 🎨 **Design Inspiration**  \n\n- [Themeforest Templates](https://themeforest.net/search/questions%20and%20answers%20template)  \n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossainshofiq%2Fperfectalt-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhossainshofiq%2Fperfectalt-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossainshofiq%2Fperfectalt-client/lists"}