Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

🔧 Local Service Finder

"Uber, but for local services" — Find trusted electricians, plumbers, cleaners, and more in your area.

Status License Node

🌟 Overview

Local Service Finder is a full-stack web platform that connects customers with reliable local service providers in Pakistan. Whether you need an AC technician, a plumber, or a house cleaner — find verified professionals near you with ratings, pricing, and real work history.

❓ Problem

Finding a reliable local worker is difficult:

  • Your AC stops working → You don't know a trusted technician
  • Water pipe leaks → You need a plumber urgently
  • Electricity problem → You need an electrician
  • Need house cleaning → You don't know whom to call

People currently depend on word of mouth, Facebook groups, random Google searches, and classified ads — with no guarantee of quality, no ratings, no price transparency, and no idea who is nearby.

💡 Solution

A platform where:

  • Customers can find nearby service providers, check ratings, compare prices, and book services
  • Service Providers can create profiles, showcase their work, and get customers
  • Admins can manage the platform, verify providers, and handle disputes

🚀 Features

For Customers

  • 🔍 Search service providers by category & location
  • ⭐ View ratings and reviews
  • 📋 Book services with detailed request forms
  • 📊 Track booking status in real-time
  • 💬 Rate and review completed services

For Service Providers

  • 👤 Create professional profiles with work history
  • 🛠️ Add and manage services with pricing
  • 📸 Upload previous work images
  • ✅ Accept/reject service requests
  • 📈 Dashboard with stats and earnings

For Admins

  • 👥 Manage users and providers
  • 📂 Manage service categories
  • 📊 View platform analytics
  • 🚫 Handle complaints and fake accounts

🛠️ Tech Stack

Layer Technology
Frontend React 19 + Vite
Styling Vanilla CSS (Glassmorphism Dark Theme)
Backend Node.js + Express.js
Database SQLite (better-sqlite3)
Auth JWT (jsonwebtoken + bcryptjs)
Image Upload Multer (local storage)
Icons Lucide React
Fonts Google Fonts (Inter + Outfit)

📂 Project Structure

Local-Service-Provider/
├── client/                # React frontend (Vite)
│   ├── public/
│   ├── src/
│   │   ├── api/           # API client
│   │   ├── components/    # Reusable UI components
│   │   ├── context/       # React Context (Auth)
│   │   ├── pages/         # Page components
│   │   ├── App.jsx
│   │   ├── main.jsx
│   │   └── index.css      # Design system
│   └── package.json
├── server/                # Express.js backend
│   ├── db/                # Database init & seed
│   ├── middleware/        # Auth middleware
│   ├── routes/            # API routes
│   ├── uploads/           # Uploaded images
│   ├── index.js
│   └── package.json
└── README.md

🏁 Getting Started

Prerequisites

  • Node.js v18 or higher
  • npm v9 or higher

Installation

  1. Clone the repository
git clone https://github.com/naushairch/Local-Service-Provider.git
cd Local-Service-Provider
  1. Setup Backend
cd server
npm install
npm start

Server runs on http://localhost:5000

  1. Setup Frontend
cd client
npm install
npm run dev

Frontend runs on http://localhost:5173

📱 Service Categories

Category Description
⚡ Electrical Wiring, fans, switches
🔧 Plumbing Pipes, taps, water heaters
🚗 Car Repair Mechanics, denting, painting
❄️ AC Repair Installation, maintenance, gas filling
🧹 Home Cleaning Deep cleaning, regular cleaning
🎨 Painting Interior, exterior painting
🪚 Carpentry Furniture, doors, cabinets
🔌 Appliance Repair Washing machines, fridges, ovens
💻 Computer Repair Laptops, desktops, networking
🌿 Gardening Lawn care, plant maintenance
🐛 Pest Control Fumigation, termite treatment

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

Naushair — @naushairch

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages