GENIE

Your Trusted Home Services Companion

📑 About

Genie is an innovative on-demand home services platform designed to revolutionize how urban dwellers maintain their living spaces. Built using the MERN stack (MongoDB, Express.js, React, Node.js), Genie connects homeowners with verified service professionals for various home maintenance and improvement tasks.

🌟 Key Features

• Verified Professionals: Access to thoroughly vetted service providers
• Real-time Booking: Schedule services on-demand or in advance
• Secure Payments: Integrated payment system using Razorpay
• Service Tracking: Real-time tracking of service status
• Review System: Transparent ratings and reviews for quality assurance
• User Profiles: Personalized dashboards for both customers and service providers
• Location Services: Google Maps integration for accurate service area mapping
• Multiple Service Categories: Including:
  • Women's Salon & Spa
  • Men's Salon & Spa
  • AC Appliances & Repair
  • Cleaning & Pest Control
  • And more...

💻 Tech Stack

Frontend

• React.js
• JavaScript
• Tailwind CSS

Backend

• Node.js
• Express.js
• MongoDB
• JWT Authentication

Integrations

• Razorpay Payment Gateway
• Google Maps API
• JWT for Authentication

🚀 Setup and Installation

Prerequisites

• Node.js (v14 or later)
• npm (Node Package Manager)
• MongoDB (v4.4 or later)
• Git

Getting Started

1. Clone the Repository

   git clone https://github.com/Agarwalyash14/Genie.git
   cd Genie

2. Frontend Setup

   cd client
   npm install
   npm run dev

   Frontend will run on http://localhost:5173

3. Backend Setup

   cd server
   npm install
   nodemon index.js

   Server will run on http://localhost:5000

4. Environment Variables Create .env files in both client and server directories with necessary configurations.

   .env.example (Server)

   PORT = 5000
   CLIENT_URL = http://localhost:5173
   NODE_ENV = development
   MONGODB_URI = mongodb://localhost:27017/Genie
   # Example for MongoDB Atlas: mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority&appName=YourAppName
   JWT_SECRET = your_jwt_secret_key_here
   RAZORPAY_KEY_SECRET = your_razorpay_secret_key_here
   RAZORPAY_KEY_ID = your_razorpay_key_id_here

   .env.example (Client)

    VITE_PLACES_NEW_API_KEY = YOUR_GOOGLE_PLACES_API_KEY
    VITE_BACKEND_URL = http://localhost:5000
    VITE_RAZORPAY_KEY_ID = YOUR_RAZORPAY_KEY_ID

🔑 Admin Credentials

To access the admin panel, use the following credentials:

https://yourgenie.vercel.app/

• Admin Email: admin@gmail
• Admin Password: admin@1234
• Admin Email: /admin

🌈 Benefits

For Users

• Convenient booking system
• Access to verified professionals
• Transparent pricing
• Secure payment options
• Time-saving solution
• Real-time service tracking

For Service Providers

• Increased visibility
• Steady stream of clients
• Professional profile management
• Secure payment processing
• Feedback system for reputation building

🛣️ Future Scope

• Geographic Expansion: Extending services beyond urban centers
• Service Diversification: Adding specialized service categories
• AI Integration: Smart service recommendations
• Community Features: Building a service provider network
• Sustainability Initiatives: Eco-friendly service options
• Advanced Analytics: Data-driven insights for service optimization

👥 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

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