https://github.com/semanto-35/service-sphere-client
The Service Review Application System is a platform that allows users to review and interact with various services.
https://github.com/semanto-35/service-sphere-client
express firebase javascript mongodb nodejs react talwindcss
Last synced: 3 months ago
JSON representation
The Service Review Application System is a platform that allows users to review and interact with various services.
- Host: GitHub
- URL: https://github.com/semanto-35/service-sphere-client
- Owner: Semanto-35
- Created: 2025-02-05T11:52:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-12T13:43:20.000Z (over 1 year ago)
- Last Synced: 2025-04-05T09:15:00.809Z (over 1 year ago)
- Topics: express, firebase, javascript, mongodb, nodejs, react, talwindcss
- Language: JavaScript
- Homepage: https://service-sphere-3137f.web.app/
- Size: 265 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ⭐ **Service Review Application System**
## 🏆 **Project Overview**
The **Service Review Application System** is a platform that allows users to **review and interact** with various services. It helps users find **reliable services** by providing **detailed feedback and ratings** on categories like **Web Hosting, Digital Marketing, Software Development, and more**.
Users can:
✔ **Log in securely** with email/password or Google/GitHub authentication.
✔ **Add, update, and delete services** they have listed.
✔ **Browse services, read reviews, and submit ratings**.
✔ **Search for services** and filter them by category.
✔ **Manage their own reviews** and track engagement.
---
## 🌍 **Live Demo**
🔗 **Live Website:** [Service Review System](https://service-sphere-3137f.web.app/)
---
## 🚀 **Key Features**
✔ **User Authentication** – Secure login and registration with **email/password or Google/GitHub login**.
✔ **Service Management** – Users can **add, update, and delete** their own services.
✔ **Service Details & Reviews** – Browse service details, read reviews, and submit ratings.
✔ **Search & Filter** – Find services quickly using **search and category filters**.
✔ **Responsive Design** – Fully optimized for **mobile, tablet, and desktop views**.
✔ **Dynamic Countup** – Displays total **services, reviews, and users dynamically**.
✔ **Error Handling** – Graceful **error handling** for failed requests and unauthorized access.
✔ **JWT Authentication** – Secure API with **JSON Web Token (JWT)** authentication.
---
## 🛠️ **Tech Stack**
### **Frontend**
- **React.js** – UI framework for a fast and dynamic interface.
- **React Router DOM** – Manages client-side routing.
- **Tailwind CSS** – Utility-first CSS framework for modern UI.
- **Material Tailwind** – Material UI components for **Tailwind CSS**.
- **React Query** – Handles **efficient data fetching & state management**.
- **React Toastify** – Displays **toast notifications**.
- **React Countup** – Animates the total **number of users, reviews, and services**.
- **Axios** – Handles **API requests** efficiently.
- **Lottie React** – Adds **smooth animations** with Lottie files.
- **SweetAlert2** – Displays **customizable alerts**.
- **Swiper** – Integrates **sliders and carousels**.
### **Backend**
- **Express.js** – A lightweight and fast **Node.js framework**.
- **MongoDB** – A **NoSQL database** to store services, reviews, and users.
- **JWT (JSON Web Token)** – Ensures **secure authentication**.
- **Cookie-Parser** – Parses cookies in the backend.
- **CORS** – Enables **cross-origin requests** between frontend and backend.
- **Dotenv** – Manages **environment variables**.
---
## 📦 **Dependencies Used**
```json
{
"react": "^18.0.0",
"react-router-dom": "^6.10.0",
"axios": "^1.4.0",
"firebase": "^9.6.11",
"react-toastify": "^9.0.0",
"react-icons": "^4.8.0",
"tailwindcss": "^3.2.4",
"react-query": "^4.29.0",
"react-countup": "^6.1.0",
"sweetalert2": "^11.4.8",
"swiper": "^8.4.7",
"jsonwebtoken": "^9.0.0",
"express": "^4.18.2",
"mongoose": "^6.7.0",
"cookie-parser": "^1.4.6",
"cors": "^2.8.5",
"dotenv": "^16.0.0"
}
```
---
## 🛠️ **How to Run the Project Locally**
### **1️⃣ Clone the Repository**
```bash
git clone https://github.com/Semanto-35/service-sphere-client.git
cd service-review-app
```
### **2️⃣ Install Dependencies**
For the **frontend**:
```bash
cd client
npm install
```
For the **backend**:
```bash
cd server
npm install
```
### **3️⃣ Configure Environment Variables**
Create a `.env` file in the **server** directory and add:
```env
PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key
FIREBASE_API_KEY=your_firebase_api_key
```
### **4️⃣ Start the Development Server**
Run the **backend**:
```bash
cd server
npm run dev
```
Run the **frontend**:
```bash
cd client
npm run dev
```
### **5️⃣ Open in Browser**
Visit `http://localhost:5173` to view the project. 🚀
---
## 🔗 **Live Project & Resources**
🔗 **Live Demo:** [Visit Here](https://service-sphere-3137f.web.app/)
📂 **GitHub Repository:** [Service Review GitHub](https://github.com/Semanto-35/service-sphere-client)
---
## 🎖 **Acknowledgments**
🙏 Thanks to the contributors of **TailwindCSS, React, Firebase, MongoDB, and other open-source tools** that made this project possible!
---
## 📧 **Contact & Support**
📫 Reach me at: [**sabbirhossainsemanto@gmail.com**](mailto:sabbirhossainsemanto@gmail.com)