Welcome to fixmate

System requirements

Before you run the installer, ensure the target server meets the minimum requirements:

• PHP 8.2+ with extensions: OpenSSL, PDO, Mbstring, Tokenizer, JSON, cURL, Fileinfo, BCMath.
• Database: MySQL 8, MariaDB 10.5+, PostgreSQL 12+, or SQL Server 2019+.
• Queue backend (database driver supported by default; Redis or others optional).

cPanel: create database & upload files

Database & user

1. Open MySQL® Databases in cPanel and create a database (for example fixmate_db).
2. Create a database user with a strong password, then add the user to the database granting ALL PRIVILEGES.

Upload application files

1. Upload fixmate Zip file
2. In File Manager go to public_html/ (or the target directory) and upload the archive, then extract it.

Without terminal access, you can complete migrations by visiting /install after uploading.

Now Visit: yourdomain.com/install

1. Welcome

Quick intro, high-level checklist, and a reminder about server requirements.

2. Requirements

Automated PHP version and extension checks. You must satisfy all prerequisites to continue.

3. Permissions

Validates directory write access for storage and bootstrap/cache.

4. Environment

Guided form covering application info, database credentials, cache/session drivers, and mail setup. Values are persisted to .env.

5. Database

Runs migrations, seeds all demo data, performs artisan maintenance commands, and logs output in real time.

6. Finish

Displays environment summary, seeded demo accounts, and the path to the storage/installed marker.

Step 1: Welcome



Step 2: Requirements



Step 3: Permissions



Step 4: Environment



Step 5: Database



Step 6: Finish

Manual installation fallback

If you cannot access the browser wizard (headless servers, CLI-only environments), follow these steps:

1. Copy the environment template and update manually:
   cp .env.example .env php artisan key:generate
2. Configure database credentials in .env, ensure the database exists, then run:
   php artisan migrate --force php artisan db:seed --force
3. Run final commands to clear caches and ensure the app key exists:
   php artisan optimize:clear php artisan key:generate --force
4. Create the installation marker to skip the wizard:
   php -r "file_exists('storage/installed') || touch('storage/installed');"

php artisan key:generate

Advanced Server & Manual Setup

For professional developers and those deploying on VPS/Dedicated servers, this section provides detailed configuration requirements and manual installation steps.

Advanced .env Configuration

Manual Deployment (SSH)

# Install Dependencies
composer install --optimize-autoloader --no-dev

# Initialize App
cp .env.example .env
php artisan key:generate

# Database & Symlink
php artisan migrate --force
php artisan db:seed --force
php artisan storage:link

# Permissions (Ubuntu/Debian)
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

Nginx Configuration Example

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/fixmate/public;

    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    }
}

Demo accounts

The seeders provision three ready-to-use accounts for quick testing. All use the password password.

Features & Configuration

Learn how to utilize the software's features and configure settings.

1. Admin Dashboard

The Admin Dashboard provides a comprehensive overview of your platform's performance. At a glance, you can monitor key metrics such as:

• Booking Statistics: Track Total, Awaiting, Active, and Completed bookings.
• Financial Overview: View Total Sales, Withdraw Requests, and Refund Requests.
• User Growth: Monitor New Client and Provider registrations.

The data is organized by time periods (Today, This Month, This Year, and All Time) to help you analyze trends effectively.

(More detailed steps and images will be added here manually.)

2. Bookings Management

The Bookings section is the central hub for managing all service appointments. It allows administrators to track the lifecycle of every booking, from initial request to completion or cancellation.

Sub-menu Items

• All Bookings: View a master list of every booking in the system regardless of status.
• Awaiting Approval: Bookings that require immediate attention and confirmation.
• Confirmed Bookings: Scheduled appointments that are approved and pending service delivery.
• Completed Bookings: History of successfully finished services.
• Cancelled Bookings: Services that were cancelled by the customer, provider, or admin.
• Refunded: Bookings where payment has been returned to the customer.

Key Functionalities

• Statistics Overview: Quick summary cards showing counts for Total, Pending, Completed, and Cancelled bookings.
• Advanced Filtering: Quickly locate specific bookings using filters for:
  • Search: Find by booking number, customer name, or email.
  • Status: Filter by booking status (e.g., Pending, Completed).
  • Payment Status: Filter by payment condition (e.g., Paid, Unpaid).
  • Date Range: Narrow down results by selecting a "From" and "To" date.
• Actionable Insights: The data table provides key details like Booking #, Customer info, Service type, Date & Time, Amount, and Status.
• Manage Actions: Use the action buttons to view full booking details or update statuses directly.

3. Manage Services

This section gives administrators full control over the services offered on the platform. You can oversee service listings, approve new submissions, manage categories, and moderate reviews.

Sub-menu Items

• All Services: A comprehensive list of every service currently in the system.
• Awaiting Approval: New services submitted by providers that need admin verification before going live.
• Service Categories: Create and manage the taxonomy (categories/subcategories) for organizing services.
• Service Reviews: Moderate and view customer feedback left for services.

Key Functionalities

• Comprehensive Search & Filter: Locate specific services efficiently using:
  • Search: Type a service name to find it instantly.
  • Filter by Status: View services based on their current state (e.g., Active, Inactive).
  • Filter by Category: Narrow down the list to specific service types (e.g., House Cleaning, Plumbing).
  • Filter by Provider: See all services offered by a specific provider.
• Service Overview: The table displays vital information including:
  • Image & Name: Visual thumbnail and service title.
  • Featured Badge: Indicates if a service is highlighted as "Featured" on the platform.
  • Details: Provider name, Category, and Price.
  • Status: Current operational status (e.g., Active).
• Action Menu: Use the action button (gear icon) to edit details, change status, or delete services.

4. Service Reviews

The Service Reviews section allows admins to moderate customer feedback, ensuring that reviews are genuine and appropriate for the platform.

Key Features

• Bulk Actions: Quickly manage multiple reviews at once using the top-right buttons:
  • Bulk Approve: Publish selected reviews instantly.
  • Bulk Reject: Mark selected reviews as rejected.
  • Bulk Delete: Permanently remove selected reviews.
• Advanced Filtering: Find specific reviews using filters for:
  • Service: View reviews for a specific service.
  • Rating: Filter by star rating (1-5 stars).
  • Status: Filter by approval status (Pending, Approved, Rejected).
  • Featured: Show only reviews marked as featured.

Review Management

The reviews table provides detailed information and individual actions:

• User & Service: Identifies who left the review and for which service.
• Rating & Comment: Displays the star rating and the customer's written feedback.
• Status Indicators: Shows if a review is currently Approved or pending.
• Actions:
  • View (Eye Icon): See full review details.
  • Toggle Status (X/Check Icon): Approve or Reject the review.
  • Feature (Star Icon): Highlight the review on the service page.
  • Delete (Trash Icon): Remove the review.

5. Provider Management

The Provider Management section is the command center for overseeing all service providers on the platform. It offers tools to search, verify, edit, and monitor provider activities.

Key Functionalities

• Search & Filter:
  • Search Bar: Quickly find providers by name, email, or phone number.
  • Filter by Status: Isolate providers based on their account status (e.g., Unverified, Active).
• Provider List Overview: The main table displays essential provider data:
  • Avatar & Name: Visual identification and full name.
  • Contact Info: Email address and phone number.
  • Status: Current verification status (e.g., Unverified).
  • Metrics: Number of active services and current wallet balance.
  • Joined Date: When the provider registered on the platform.

6. User Management

The User Management section provides complete control over the customer base. Admins can view, edit, and manage all registered users on the platform.

Key Functionalities

• Search & Filter:
  • Search Bar: Locate users by name, email, or phone number.
  • Filter by Status: View users based on their account status (Active, Inactive).
• User List Overview: The table displays critical user information:
  • User Info: Avatar, Name, and Email address.
  • Contact: Phone number.
  • Status: Current account status (e.g., Active).
  • Joined Date: Registration date.

7. Transactions

The Transactions section provides a comprehensive financial overview of all bookings. Admins can track payments, monitor statuses, and view detailed transaction histories.

Key Functionalities

• Advanced Filtering:
  • Search: Find transactions by booking number or customer details.
  • Payment Status: Filter by status (e.g., Paid, Unpaid, Refunded).
  • Payment Method: Filter by gateway (e.g., Stripe, PayPal, Cash).
  • Date Range: Select a specific period to analyze transactions.
• Transaction List: The table presents essential financial data:
  • Booking Reference: Unique booking ID and transaction codes.
  • Customer: Payer's name and email.
  • Amount: Total transaction value including extras.
  • Status: Visual indicators for Payment Status (e.g., Paid) and Booking Status.
  • Date: Timestamp of the transaction.

8. Offline Payments

The Offline Payments section handles manual transaction verifications. Admins can review, approve, or reject payments made through offline channels (e.g., Bank Transfer, Cash).

Key Functionalities

• Search & Filter:
  • Search: Locate transactions by booking number or transaction ID.
  • Status Filter: Filter list by payment status (e.g., Pending, Verified).
• Approval Workflow:
  • Approve: Confirm that funds have been received and mark the booking as paid.
  • Reject: Decline invalid or unverified payment attempts.
• Bulk Actions: Efficiently process multiple payment records simultaneously.

9. Refund Requests

The Refund Requests section allows admins to manage and process refund claims from customers. It provides a centralized view of all refund activities and their current statuses.

Key Functionalities

• Request Overview: The table lists all refund requests with detailed information:
  • Refund & Booking IDs: Unique identifiers for tracking.
  • Parties Involved: Customer and Provider names.
  • Financials: Refund amount requested.
  • Statuses: Tracks the overall Status, Admin Status, and Provider Status independently.
• Filtering:
  • Filter by Status: Use the "Filter by Status" dropdown to view requests based on their processing stage (e.g., Pending, Approved, Rejected).
• Actions: Admins can take action on individual requests to approve or decline the refund.

10. Support Tickets

The Support Tickets section is the central help desk for managing user inquiries and issues. Admins can view, assign, and resolve tickets to ensure high customer satisfaction.

Key Functionalities

• Ticket Management:
  • Search & Filter: Find tickets by ID, subject, or description. Filter results by Status, Priority, or Type.
  • Ticket List: Displays Ticket #, Subject, Type, Priority, Status, Creator, Assignee, and Date.
  • Actions: Options to view details, reply, or update ticket status.

11. Provider Withdrawals

The Provider Withdrawals section allows admins to manage payout requests from service providers. It offers a clear view of financial obligations and processing statuses.

Key Functionalities

• Dashboard Stats: Top-level metrics cards providing an instant financial summary:
  • Request Counts: Total, Pending, Processing, Completed, Cancelled, and Failed requests.
  • Financial Totals: Total Completed payout amount and Pending Amount waiting for approval.
• Filter Withdrawals:
  • Status & Method: Filter requests by their current state (e.g., Pending) or payout method.
  • Date Range: Narrow down requests within a specific timeframe ("From" and "To").
  • Search: Find specific requests by provider name or ID.
• Withdrawal Requests List: A detailed table (when data is available) showing individual request details for processing.

12. Homepage Content Management & Theme Manager

The Homepage CMS & Theme Manager section gives admins full control over the landing page design, theme layouts, and dynamic content without touching any code.

Theme Manager & Layout Switcher

FixMate includes 5 pre-designed modern homepage layouts. Navigate to Settings > Homepage Settings to enable available themes or select your primary default landing page.

Homepage 1 (Classic)

Classic layout featuring main hero search, top category icons, and provider highlights.

Homepage 2 (Modern Grid)

Modern grid-focused design showcasing featured services and direct booking actions.

Homepage 3 (Search Focus)

Search-first interface designed for fast location-based service lookups.

Homepage 4 (Animated GSAP)

Premium GSAP animated design with sleek dark accents and smooth interactions.

Homepage 5 (Marketplace)

Full marketplace layout highlighting top-rated service packages and provider profiles.

Editable Sections

• Hero Section: Update the main headline, subtext, and hero image to make a strong first impression.
• Categories & Services: Manage the titles and descriptions for the "Most Popular Services" and "Top Services" sections.
• Work Process: Define the steps in the "How It Works" section (e.g., Book, Pay, Relax).
• Why Choose Us: Edit the value proposition points and associated images.
• App Promotion: Update the mobile app download section content and links.
• Testimonials & Blog: Manage the section titles for user reviews and latest news.

13. Mobile Banners

The Mobile Banners section allows admins to manage the promotional banners displayed within the mobile application. This is essential for running campaigns and highlighting special offers.

Management Features

• Banner List: View all active and inactive banners with details like Image, Title, Sort Order, and Status.
• Status Control: Quickly toggle banners on or off without deleting them.
• Ordering: Define the display order using the "Sort Order" field to prioritize important promotions.

14. Header & Footer

Manage the global header and footer settings, including contact information and social media links.

15. Location Management

The Locations section allows you to define the geographical areas where your services are available. This includes managing Countries and States.

16. Payment Method Configuration

The Payment Methods section allows you to configure and manage the payment gateways available on your platform. You can enable multiple gateways and customize their settings to suit your business needs.

Supported Gateways

The platform supports a wide range of popular payment gateways, selectable from the left sidebar:

• PayPal & Stripe: Global leaders for online payments.
• Razorpay, Flutterwave, PayStack: Popular regional options for India and Africa.
• Mollie: Leading payment provider for Europe.
• SSLCommerz: Popular gateway for Bangladesh.
• Bank Account: For manual bank transfer handling.

Configuration Settings

When you select a gateway (e.g., Stripe), you can configure the following settings:

• Enable/Disable Switch: Use the toggle switch in the top right corner to instantly enable or disable the gateway on the frontend.
• Display Name: The name shown to users during checkout (e.g., "Stripe").
• Description: A short text explaining the payment method to the user.
• Account Mode: Switch between "Sandbox" (for testing) and "Live" (for real transactions).
• Currency Settings:
  • Currency Name: The currency code used for transactions (e.g., USD).
  • Currency Rate: The exchange rate relative to the default system currency (usually 1.0000 if same).
• API Credentials: Enter the required keys provided by the payment gateway (e.g., Client ID, Secret Key, Public Key).
• Logo Image: Upload a custom logo for the payment method to be displayed on the checkout page.

17. Blog Management

The Blog Management section enables you to publish and manage articles to engage your audience and improve SEO. You can organize posts by category and interact with user comments.

Key Functionalities

• Search & Filter: Find specific blogs by title, category, status, or homepage visibility.
• Blog List: View all blog posts with thumbnails, titles, categories, and creation dates.
• Quick Actions:
  • Show Homepage: Toggle to feature specific posts on the homepage.
  • Is Active: Enable or disable posts without deleting them.
  • Actions: View, Edit, or Delete posts.

Sub-menu Items

• All Blogs: The main list view of all articles.
• Add New Blog: Create rich content with images and text.
• Blog Categories: Manage the topics for your blog posts.
• Blog Comments: Moderate and reply to user comments.

18. Frontend Testimonials Management

The Frontend Testimonials Management section allows you to manage the testimonials displayed on the frontend of your platform. You can filter, feature, and edit testimonials to engage your audience.

Key Functionalities

• Search & Filter: Find specific testimonials by client name, message, status, featured status, or rating.
• Testimonials List: View all testimonials with client details, message, position, rating, status, and featured status.
• Quick Actions:
  • Featured Toggle: Toggle to feature specific testimonials on the frontend.
  • Status Toggle: Enable or disable testimonials without deleting them.
  • Actions: View, Edit, or Delete testimonials.

19. Terms & Custom Pages Management

The Pages Management section allows you to configure essential static pages and custom content for your platform. This includes legal documents, contact information, and FAQs.

Available Pages

• Contact Us: Configure your contact details (Email, Phone, Address) and embed a Google Map.
• Custom Page: Create dynamic pages with custom content as needed.
• Terms & Conditions: Define the legal terms for using your platform.
• Privacy Policy: Outline how you handle user data and privacy.
• FAQ: Manage Frequently Asked Questions to help users find answers quickly.

20. Email Configuration

The Email Configuration section is critical for ensuring your platform can send transactional emails (bookings, resets, notifications) reliably. We recommend using an SMTP provider.

SMTP Settings

• Mail Driver: Select "SMTP" for the most reliable delivery.
• Mail Host: The server address provided by your email service (e.g., smtp.gmail.com).
• Mail Port: Common ports are 587 (TLS) or 465 (SSL).
• Mail Encryption: Choose TLS or SSL based on your provider's requirements.
• SMTP Credentials: Enter your Username (email) and Password (or App Password).
• From Address & Name: Define the sender email and name that users will see in their inbox.

21. Global Settings

The Global Settings dashboard is the command center for your platform's core configuration. It provides a centralized view of all major system preferences.

Configuration Modules

Provider Panel Features

The Provider Panel is a dedicated interface for service providers to manage their bookings, services, and earnings. It includes all necessary tools to run their service business efficiently.

1. Provider Dashboard

The Dashboard gives providers a snapshot of their business performance.

Key Metrics

• Recent Bookings: A list of the latest service requests with customer details and status.
• Daily Overview (Today): Tracks new bookings, earnings, and client interactions for the current day.
• Monthly & Yearly Stats: Comprehensive breakdown of total bookings, earnings, and withdrawal requests over time.
• Financial Summary: Quick view of Total Earnings, Wallet Balance, and Pending Withdrawals.

2. My Bookings

A comprehensive booking management system that allows providers to track and update booking statuses.

• All Bookings: View a complete history of all bookings.
• Awaiting Approval: Bookings that require provider confirmation.
• Confirmed Bookings: Scheduled bookings that are ready to be served.
• In Progress: Services currently being delivered.
• Completed Bookings: Successfully finished services.
• Cancelled/Refunded: Track cancelled bookings and processed refunds.

3. Refund Requests

Manage refund requests from customers. Providers can view the reason for the refund and the current status of the request (e.g., Pending, Approved, Rejected).

4. Manage Services

Providers can fully manage their service offerings from this section.

• All Services: List of active and inactive services.
• Add New Service: Create new service listings with descriptions, pricing, duration, and images.

5. Earnings & Wallet

A financial hub for the provider to track income and manage payouts.

• Dashboard: Visual representation of earnings over time.
• Transaction History: Detailed log of every transaction.
• Withdrawals: View past withdrawal history and status.
• Request Withdrawal: Submit a request to withdraw funds to a connected payment account (Bank, PayPal, etc.).

6. Appointment Schedule

Manage availability and working hours. Providers can set their schedule to ensure they only receive bookings when they are available.

7. Service Reviews

View feedback and ratings left by customers. This helps providers understand their performance and areas for improvement.

Update System

Keeping your system up-to-date is crucial for security and new features. The built-in updater allows you to apply database changes automatically.

One-Click Updater

Once you have uploaded the new files and restored your configuration:

1. Login to the Admin Panel.
2. Navigate to Settings > System Updater.
3. The system will compare your current database version with the codebase version.
4. If an update is available (e.g., Codebase Version > Database Version), the Update System Now button will be active.
5. Click the button to safely run migrations and update the system version.

Watch Update Tutorial

Click to open the step-by-step video guide