Skip to content

isuri54/servicehub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

95 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ServiceHub — Full-Stack Service Booking Platform

CI/CD Pipeline Frontend: http://localhost:3000 | Backend: http://localhost:5000

ServiceHub is a Dockerized MERN-stack platform that connects clients with verified local service providers (plumbers, carpenters, cleaners, electricians, etc.). Clients can discover, chat, book, and review providers — all in one seamless experience. Built with modern DevOps practices: Docker, CI/CD, real-time chat, role-based access, responsive design.

Features

Provider Discovery & Booking: Search for verified service providers by category and district, view detailed profiles with work portfolio, ratings, experience, and availability, then book instantly via an interactive calendar (single-day or long-term projects). Real-Time Chat System: Initiate and manage private conversations with providers, enjoy live messaging powered by Socket.io, and stay connected throughout the booking process with a clean, mobile-friendly interface. Smart Booking Calendar: Choose single-day services or long-term projects, see provider availability in real-time, avoid booked/unavailable dates automatically, and receive instant confirmation upon booking. District-Based Filtering: Filter providers by your district to find local professionals quickly and reliably — perfect for urgent or location-specific jobs. Provider Dashboard & Earnings: Providers get a dedicated portal to manage their profile, view upcoming jobs, track total earnings, respond to messages, and update availability — all in one place. Reviews & Rating System: After a completed job, clients can leave star ratings and written reviews. Providers build reputation and trust with every positive feedback. Responsive & Mobile-First Design: Beautiful, fast, and fully functional on phones, tablets, and desktops — built with Tailwind CSS for a modern user experience. Dockerized Full-Stack Architecture: Frontend (React + Nginx), Backend (Node.js/Express), and Database (MongoDB) all run in separate containers, deployable with a single command. CI/CD Ready: GitHub Actions pipeline automatically tests and builds the app on every push.

Teck Stack

Frontend: React 19, React Router v7, Tailwind CSS Backend: Node.js, Express, Socket.io Database: MongoDB Auth: JWT + RBAC + bcrypt File Upload: Multer + local storage Container: Docker + Docker Compose CI/CD: GitHub Actions

Screenshots

Signup Page

Screenshot 2025-12-11 011444 ### Login Page Screenshot 2025-12-11 011411 ### Become Provider Page Screenshot 2025-12-13 005738 ### Home Page Screenshot 2025-12-11 001619 Screenshot 2025-12-10 231443 ### Category Providers Page Screenshot 2025-12-13 000603 ### My Bookings Page Screenshot 2025-12-11 004339 ### Messages Screenshot 2025-12-13 004338 ### User Profile Screenshot 2025-12-10 232006 ### Provider Profile View Page Screenshot 2025-12-13 004837 ### Bookings Screenshot 2025-12-13 000703 ### Send Messages Screenshot 2025-12-13 001124 ### Call Provider Screenshot 2025-12-13 000735 ### Provider Dashboard Screenshot 2025-12-13 001238 Screenshot 2025-12-13 001304 ### Update Availability Screenshot 2025-12-13 001340 ### Quick Stats Screenshot 2025-12-13 001412 ### My Earnings Screenshot 2025-12-13 001514 ### Provider Profile Screenshot 2025-12-13 001549 ### Messages (Provider) Screenshot 2025-12-13 004338

Getting Started

(Docker) Clone the repository: git clone https://github.com/isuri54/servicehub.git cd servicehub

docker-compose up --build

(Manual) #Backend cd backend npm install npm run dev

#Frontend cd frontend npm install npm start

About

Servicehub is a two-sided web platform that connects skilled service providers (e.g., cleaners, welders, mechanics, drivers, plumbers, electricians) with clients seeking reliable, on-demand services. Built with the MERN stack (MongoDB, Express.js, React.js, Node.js), it emphasizes simplicity, trust, and local discovery.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages