🏆 City Service App — Service at Home Platform (Multi Payment Gateways | Multi Login)

On-demand home services marketplace with secure payments & role-based access — SEO-optimized, E-E-A-T compliant, and prepared for GPL redistribution on wpshop.net.

🚀 Overview

The City Service App is a complete mobile platform enabling users to book professionals at home —
including plumbers, electricians, cleaners, beauty experts, and more.
It supports multi-vendor operations, multiple payment providers, and a robust role system
for Admin, Service Providers, and Customers.

Experience: Modeled after leading marketplaces (e.g., UrbanClap/TaskRabbit) — appointment management,
service categories, real-time status updates, and trusted ratings that help users choose the right expert quickly.

✨ Key Features

• Multi-Login System: Customer, Provider, Admin all with dedicated controls.
• Service Marketplace: categories, detailed listings, availability, & pricing tables.
• Scheduling: time-slot bookings with confirmation & reminders.
• Multi-Payment: Stripe, PayPal, COD, Wallet, and additional gateways (configurable).
• Provider Dashboard: job requests, revenue tracking, ratings & profile controls.
• Order Tracking: job acceptance → arrival → completion → payment.
• Reviews & Ratings: build trust & quality assurance for all service listings.
• Push Notifications: job updates, promotions, and service reminders (via FCM).
• Localization + RTL: full Arabic support for Middle East & global rollouts.
• Promo & Coupons: marketing campaigns to boost bookings.

⚙️ Technical Stack

• Mobile App: Flutter 3.x (Dart), deployable to Android & iOS.
• Backend: PHP + MySQL with REST API integration (Laravel or CI depending on version).
• Auth: JWT for secure authentication across roles.
• Maps: Google Maps API for location & routing.
• Push Messaging: Firebase Cloud Messaging.
• Server Requirements: PHP 8.0+, MariaDB/MySQL 5.7+, HTTPS enabled.

🧩 Installation Guide

1. Install Backend: upload source, create DB, import SQL schema.
2. Configure .env/API: database credentials, JWT keys, payment & map credentials.
3. Set API URL: update API_BASE_URL inside Flutter project.
4. Brand App: change package IDs, logos, splash screens & primary theme colors.
5. Firebase Setup: integrate FCM for order-related notifications.
6. Build & Deploy: flutter build apk / flutter build ipa and publish to store.

📦 Deliverables

• Flutter source code for Android & iOS builds.
• Backend REST API + Admin Panel sources.
• SQL database schema & sample content.
• Documentation for configuration & publishing.
• Graphics assets (icons, placeholder banners).

📱 Supported Platforms

• Android: 6.0 (API 23)+
• iOS: 12+ with App Store publishing support
• Admin Dashboard: works on any modern web browser

🧠 Notes

• License: distributed under the GNU GPL for development, testing & educational usage.
• Compliance: ensure payment gateway policies and local regulations (e.g., taxes & service licensing).
• SEO Keywords: home service app, service booking marketplace, provider management Flutter app.
• Scalability Tips: enable cache, queue workers & image optimization for high-volume requests.

👨‍💻 Original Developer Credit

Full acknowledgment to the original developer.
For commercial usage, updates & technical support visit:
CodeCanyon.

🔒 Disclaimer

This software is provided under the GNU General Public License (GPL) solely for
testing, learning & development. We are not affiliated with or endorsed by the original author.
All brand names and assets remain their respective owners’ property.
For operating a live commercial marketplace, please purchase a valid license from the official provider.