Local Seva

Welcome to Local Seva, your one-stop platform for local services. Whether you need a handyman, a plumber, a maid, or any other service, Local Seva connects you with trusted professionals in your area. With our easy-to-use interface, you can quickly find and book the services you need, making your life easier and more convenient.

Features 🎯

• Service Selection: Browse and select from a wide range of local services.
• Service Details: View detailed information about each service, including description, availability, and estimated completion time.
• Service Booking: Book services directly through the platform, selecting your preferred date and time.
• Service Provider Ratings: Read and contribute to service provider ratings and reviews to make informed decisions.
• Service History: Keep track of your service history, including past bookings and completed services.
• Service Search: Use the search bar to find specific services or service providers in your area.

Technologies Used

• React.js: A JavaScript library for building user interfaces.
• React Router: A library for routing in React applications.
• Node.js: A JavaScript runtime environment used for server-side development.
• Express: A minimalist web framework for building server-side applications with Node.js.
• MongoDB: A NoSQL document-oriented database used for storing and retrieving data.

Architecture

Local Seva follows a client-server architecture. The client-side is built using React.js, providing a seamless and interactive user experience. The server-side is powered by Node.js and Express, handling requests and managing data stored in the MongoDB database. The communication between the client and server is facilitated through RESTful APIs.

🚀 Getting Started

To get started, download the zip file of the repository. Or use
git clone https://github.com/sakshgupta/Local_Seva.git
Then navigate to the project's root directory. The project consists of three folders: client, and server.
Before starting the servers, make sure to install the dependencies by running the command: npm install in all two folders.
Note: The following environment variables need to be set up before running the servers:

• For the client-side, create a .env file in the client folder with the following variables:
  REACT_APP_MAPBOX_ACCESS_TOKEN - the api key for your mapbox
  REACT_APP_BACKEND_API - the base URL of the API server (e.g. http://localhost:3000)
  REACT_APP_STRIPE_KEY - the api key for your Stripe account
• For the server-side, create a .env file in the server folder with the following variables:
  ATLAS_URI - the connection string for your MongoDB Atlas database
  STRIPE_KEY - the secret key for your Stripe account
  NODE_MAILER_USER - the email address to use for sending email notifications
  NODE_MAILER_PASS - the password for the email address to use for sending email notifications
  JWT_SECRET - the secret key to use for JWT token generation

To start the servers:
For the client-side, start the server by running the command: npm run dev
For the server-side, start the server by running the command: npm run dev or nodemon index.js

👉 How to use the site

Local Seva provides a user-friendly interface that allows you to easily navigate and access various features. Here's a brief guide on how to use the platform:

• Browse Services: On the homepage, you'll find a list of available services. Scroll through the list or use the search bar to find specific services. Click on a service to view more details.
• Service Details: On the service details page, you'll find information about the service, including a description, availability, and estimated completion time. You can also see the ratings and reviews provided by other users. If you're interested in booking the service, click on the "Book Now" button.
• Booking a Service: When booking a service, you'll be prompted to select a preferred date and time for the service. Choose a suitable option and proceed to the next step.
• Login or Signup: If you haven't already logged in, you'll be prompted to either log in to your existing account or create a new one. Provide the necessary details and follow the instructions to complete the login or signup process.
• Confirmation and Payment: After logging in or signing up, you'll be redirected to a confirmation page where you can review the booking details. If everything looks correct, proceed to the payment step. Local Seva supports secure online payments, and you'll be guided through the payment process.
• Booking History: Once the payment is completed, you'll receive a confirmation of your booking. You can view your booking history and track the status of your bookings by accessing the "Booking History" section in your user dashboard.
• User Dashboard: The user dashboard provides a centralized location for managing your account and accessing various features. From the dashboard, you can update your profile information, view your booking history, and manage your preferences.
• Admin Panel: If you're an administrator or service provider, you can log in to the admin panel. The admin panel allows you to create and manage services, view and manage user bookings, and handle other administrative tasks related to the platform.

👥 Our Team

Our team consists of:

• Saksham Gupta: Connect with Saksham on LinkedIn and GitHub , or visit his personal website .
• Amaan Khan: Connect with Amaan on LinkedIn and GitHub

🙌 Contributions

We welcome contributions to our project. If you have any suggestions or improvements, feel free to submit a pull request or open an issue.

📜 License

This project is licensed under the MIT License - see the LICENSE.md file for details.