Skip to content

johneliud/xpertshub

Repository files navigation

XpertsHub

A Django-based service marketplace connecting customers with professional service providers across various categories including plumbing, painting, housekeeping, electrical work, and more.

Features

  • User registration and authentication for customers and companies
  • Email-based login system
  • User profiles displaying personal information and activity
  • Service marketplace with multiple categories
  • Responsive design with Tailwind CSS
  • Component-based template architecture

Technology Stack

  • Django 5.2.8
  • Python 3.12
  • PostgreSQL
  • Tailwind CSS
  • Boxicons for UI icons

Installation

Prerequisites

  • Python 3.12 or higher
  • PostgreSQL
  • Node.js (for Tailwind CSS)

Clone Repository

git clone https://github.com/johneliud/xpertshub.git
cd xpertshub

Setup Virtual Environment

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install Dependencies

pip install -r requirements.txt

Environment Configuration

Create a .env file in the project root:

SECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
DB_NAME=xpertshub_db
DB_USER=your_db_user
DB_PASSWORD=your_db_password
DB_HOST=localhost
DB_PORT=5432

Database Setup

python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser

Tailwind CSS Setup

python manage.py tailwind install
python manage.py tailwind build

Run Development Server

python manage.py runserver

Visit http://localhost:8000 to access the application.

User Types

Customers

  • Register with username, email, and date of birth
  • Browse and request services
  • View service request history in profile

Companies

  • Register with company name, email, and field of work
  • Offer services in their specialization
  • Manage service listings through profile

Service Categories

  • Air Conditioner
  • Carpentry
  • Electricity
  • Gardening
  • Home Machines
  • Housekeeping
  • Interior Design
  • Locks
  • Painting
  • Plumbing
  • Water Heaters
  • All in One (for companies offering multiple services)

Development

Running Tailwind in Watch Mode

python manage.py tailwind start

Creating Migrations

python manage.py makemigrations
python manage.py migrate

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Run tests
  5. Submit a pull request

License

This project is licensed under the MIT License.

About

The web application is a service-marketplace platform designed to seamlessly connect customers with professional companies offering a wide range of home-related services. The system provides a structured and efficient way for users to access services through a unified online platform.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors