Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Local Service Finder (Full Stack Application)

A full stack web application that helps users find and book trusted local service providers such as electricians, plumbers, tutors, and cleaners.

This platform also allows service providers to create profiles and manage their services.



📌 Problem Statement

Many people struggle to find reliable local services quickly. Small service providers also lack an online platform to promote their services.

This application solves that problem by providing a centralized platform where users can search, filter, and book local service providers easily.


🚀 Features

User Features

  • User Signup & Login
  • Search service providers
  • Filter services by category and location
  • Sort providers by ratings
  • View provider profiles
  • Book services
  • Leave reviews

Service Provider Features

  • Create service profile
  • Add services
  • Update service details
  • Manage bookings
  • Update availability

🛠 Tech Stack

Frontend

  • ReactJS
  • Tailwind CSS
  • React Router
  • Context API / Redux

Backend

  • Node.js
  • Express.js

Database

  • MongoDB

⚙️ Mandatory Features Implementation

1️⃣ Routing & Navigation

  • Home Page
  • Login Page
  • Signup Page
  • Dashboard
  • Profile Page

Implemented using React Router.


2️⃣ React Hooks Used

  • useState
  • useEffect
  • useRef
  • useContext

3️⃣ State Management

Used Context API / Redux for:

  • Authentication state
  • User information
  • Global app data

4️⃣ Authentication System

  • Signup Page
  • Login Page
  • Password validation
  • LocalStorage authentication
  • Protected routes

5️⃣ Theme Support

  • Light Mode
  • Dark Mode
  • Toggle button
  • Theme stored in LocalStorage

6️⃣ Search, Filtering & Sorting

Users can:

  • Search service providers
  • Filter by category
  • Sort by ratings or price

7️⃣ Debouncing

  • Implemented in search bar
  • Reduces unnecessary API calls

8️⃣ Pagination

  • Service provider listings
  • Reviews
  • Uses MongoDB limit and skip

9️⃣ CRUD Operations

  • Create → Add service
  • Read → View services
  • Update → Edit services
  • Delete → Remove services

🔟 API Integration

  • REST APIs using Node.js + Express.js
  • Proper error handling
  • Loading states
  • Structured responses

1️⃣1️⃣ Form Handling & Validation

  • Input validation
  • Error messages
  • Controlled components
  • User feedback

1️⃣2️⃣ Responsive UI

Fully responsive UI using Tailwind CSS:

  • Desktop
  • Tablet
  • Mobile

1️⃣3️⃣ Error Handling

Backend:

  • Try–catch blocks

Frontend:

  • User-friendly error messages

📂 Project Structure

(Add your folder structure here if needed)

About

NearFix is a smart local service platform designed to help users quickly find and connect with nearby service providers such as electricians, plumbers, technicians, and more. By leveraging location-based features, it ensures fast, reliable, and convenient solutions for everyday problems. The platform focuses on simplicity, accessibility, and effici

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages