🚀 Overview

Purpose: Facilitate on-demand home service booking, provider management, and customer engagement with an intuitive mobile and web platform.

Real-world use: Homeowners can book electricians, plumbers, cleaners, and other service providers, while businesses manage schedules, payments, and service requests.

Target users: Service providers, homeowners, on-demand home service startups, and developers seeking a GPL-compliant Flutter solution.

✨ Key Features

• Customer App: Book services, track providers, manage orders, and review services.
• Provider App: Receive jobs, update status, manage availability, and communicate with customers.
• Admin Panel: Manage users, services, providers, orders, payments, and reports.
• Service Management: Add, edit, and categorize services with pricing and descriptions.
• Payment Integration: Supports multiple gateways including Stripe, PayPal, and offline payments.
• Notifications: Push notifications, email alerts, and SMS for booking updates.
• Real-Time Tracking: Track service providers during active jobs.
• Multi-Language & Currency: Suitable for international deployment.
• Reports & Analytics: Insights on bookings, revenues, and service provider performance.
• GPL License: Fully open-source, customizable, and redistributable under GPL terms.

⚙️ Technical Stack

• Mobile App: Flutter for iOS and Android
• Backend: PHP 7.x / 8.x, Laravel Framework
• Database: MySQL / MariaDB
• Server: Apache / Nginx with PHP-FPM
• APIs: Payment gateways, notifications, and maps for provider tracking

Server Requirements: PHP extensions: mbstring, curl, json, pdo, fileinfo, openssl; minimum 2GB RAM; SSL recommended for secure transactions and communication.

🧩 Installation Guide

1. Upload Laravel backend files to your server.
2. Create a MySQL database and import handyman.sql.
3. Update .env with database credentials, API keys, and payment settings.
4. Set folder permissions for /storage and /bootstrap/cache.
5. Deploy Flutter apps on Android and iOS devices.
6. Access the admin panel to configure services, providers, and users.
7. Test booking workflow, notifications, and payments before going live.

📦 Deliverables

• Flutter mobile app source code (iOS & Android)
• Laravel backend source code (GPL licensed)
• Admin dashboard for managing services, providers, and bookings
• Database schema and sample data
• Installation and configuration documentation

📱 Supported Platforms

Mobile: Android 7.0+ and iOS 12+

Web/Admin: Chrome, Firefox, Safari, Edge

Server OS: Linux, macOS, Windows

🧠 Notes

License: GPL – Free to modify and redistribute under license terms with proper credit.

• Ideal for on-demand service startups and home service providers.
• Ensure SSL, secure hosting, and data backups for users and providers.
• Maintain author credits when redistributing.

Customization Tips:

• Add extra modules like subscription plans, ratings & reviews, or loyalty programs.
• Customize UI/UX for branding in customer and provider apps.
• Integrate additional notification systems or analytics dashboards.

👨‍💻 Original Developer Credit

This GPL release is based on the original Handyman Service – On-Demand Home Service Flutter App developed by its author(s) on CodeCanyon or similar marketplaces.
Proper attribution ensures transparency and respect for the original work.

View Handyman Service on CodeCanyon

🔒 Disclaimer

GPL Redistribution Notice: Distributed under GNU GPL for development, educational, and open-source purposes. Not affiliated with or endorsed by the original developer. Users are responsible for secure deployment, data management, and compliance.

✅ E-E-A-T Compliance (Experience • Expertise • Authoritativeness • Trustworthiness)

Experience: Designed for real-world on-demand service management including bookings, provider assignments, and payments.

Expertise: Developed using Flutter and Laravel for scalable mobile and backend solutions.

Authoritativeness: Original developer credited to ensure authenticity and transparency.

Trustworthiness: GPL licensing ensures legal redistribution; installation guidance emphasizes secure deployment, compliance, and best practices.