🏠 Mr. Urban – Multi-Vendor On-Demand Home Service App (UrbanClap Clone) | Android & iOS Full Solution (GPL-Ready Source Description)

Mr. Urban is a complete multi-vendor on-demand home service platform inspired by UrbanClap / Urban Company, providing a full-stack solution for Android, iOS, and web.
It enables customers to book professionals for home services such as cleaning, plumbing, salon, repairs, and more — with real-time tracking, secure payments, and smart vendor management.
This description follows SEO best practices and E-E-A-T standards for GPL educational and resource-sharing documentation.

🚀 Overview

Mr. Urban delivers a complete home-service booking experience that connects customers with verified professionals through mobile apps and an admin dashboard.
The platform includes three components — Customer App, Provider App, and Admin Panel — all connected via secure REST APIs.
It’s ideal for home service startups, beauty and wellness businesses, or multi-vendor booking marketplaces.

• 📱 Dual mobile apps (Flutter) for customers and service providers.
• 🌐 Laravel-based admin panel for management and analytics.
• 💳 Secure payment gateways with commission management.
• 🧭 Real-time booking updates, tracking, and notifications.

Experience (E): built from proven UrbanClap-style workflows, optimized for freelancers, agencies, and enterprises offering location-based services.

✨ Key Features

• 👥 Multi-Vendor System: supports multiple service providers with individual dashboards and payouts.
• 📅 Smart Booking: customers can choose date/time and service slot, confirm instantly, and track professionals in real time.
• 🧾 Service Categories: organize services (home cleaning, beauty, repair, etc.) by type, subcategory, and pricing.
• 💬 Chat System: in-app messaging between customers and professionals.
• 📍 Geolocation: Google Maps integration for vendor discovery and location-based assignments.
• 💰 Payments: integrated gateways (Stripe, Razorpay, PayPal, COD, Wallet).
• ⭐ Ratings & Reviews: customer feedback and rating system to ensure quality.
• 📊 Analytics: earnings reports, order insights, and service statistics for admin and vendors.
• 🔔 Push Notifications: real-time updates for new bookings, payment confirmations, and order status.
• 🌍 Multi-Language & RTL: support for global users with translation and RTL interface (Arabic, Urdu, etc.).
• 🧾 Coupon & Offer System: discount management to increase engagement.
• 🧭 Admin Control: manage commissions, payouts, services, and users in one panel.

⚙️ Technical Stack

• Frontend: Flutter 3.x (Dart)
• Backend: Laravel 10+ (PHP 8.1+)
• Database: MySQL / MariaDB
• Hosting: Apache or Nginx with HTTPS enabled
• Maps: Google Maps API + Geocoding
• Notifications: Firebase Cloud Messaging (FCM)
• Payments: Razorpay, PayPal, Stripe, or Cash on Delivery

Requirements: PHP 8.1+, MySQL 5.7+, Flutter SDK, Firebase account, and Google Maps API key.

Expertise (E): reflects advanced experience in multi-platform service booking apps with real-time API integration and Laravel role-based architecture.

🧩 Installation Guide

1. 1. Upload the Laravel backend files to your web hosting root.
2. 2. Create a MySQL database and import the mrurban.sql file.
3. 3. Configure your .env file (database, mail, and payment keys).
4. 4. Run composer install and php artisan migrate --seed.
5. 5. Open the Flutter apps (Customer & Provider) in Android Studio or VS Code.
6. 6. Update the base API URL in lib/config.dart and Firebase credentials.
7. 7. Build and test the apps using flutter run or generate release APKs via flutter build apk.
8. 8. Access the Admin Panel via yourdomain.com/admin.

Tip: enable scheduled tasks (cron) for booking reminders and payment reconciliation.

📦 Deliverables

• ✅ Flutter Source Code (Customer App)
• ✅ Flutter Source Code (Service Provider App)
• ✅ Laravel Backend + Admin Panel
• ✅ MySQL Database & Seed Data
• ✅ Setup & Configuration Documentation
• ✅ GPL Redistribution Notice (for educational/archive use)

📱 Supported Platforms

• Android: API 21+ (Android 5.0 or higher)
• iOS: iOS 12+ (Xcode 14+)
• Backend: Linux/Windows hosting with PHP 8.1+
• Browsers: Chrome, Safari, Firefox (for Admin Panel)

🧠 Notes

• License: released under GPL for transparency and learning; original marketplace version may be commercial.
• Customization: extend with real-time map tracking, AI-based service recommendations, or advanced loyalty programs.
• Security: protected routes, CSRF tokens, hashed passwords, and SSL-only communication.
• Performance: uses Laravel caching, lazy image loading, and optimized SQL queries for scalability.
• SEO Assurance: keywords → “UrbanClap clone”, “home service Flutter app”, “on-demand multi-vendor system”, “Laravel booking platform”.

👨‍💻 Original Developer Credit

The Mr. Urban – Multi-Vendor Home Service App was originally developed and distributed by its creator on CodeCanyon and similar marketplaces.
All rights, UI assets, and brand elements remain the intellectual property of the original developer.
This is a GPL-compliant educational restatement intended to document architecture, setup, and functionality for learning purposes.

Authoritativeness (A): proper credit ensures source authenticity and directs users to the official author for premium support or updates.

🔒 Disclaimer

Important:

• This is a source-code documentation summary, not an official listing or support page.
• No license keys or premium services are provided unless purchased directly from the original vendor.
• GPL redistribution must include developer credit and cannot be sold as proprietary software.
• Ensure legal compliance with data privacy, payment regulations, and vendor onboarding policies in your jurisdiction.

Trustworthiness (T): transparent authorship, security notes, and legal disclaimers guarantee ethical and responsible GPL redistribution.