🚀 Overview

Designed for automotive marketplaces, dealerships, and listing platforms, AdMotors enables users to post car ads,
explore nearby listings, negotiate via chat, and manage their account — all powered by a clean UI and scalable backend API.

Experience-driven design: The app follows marketplace patterns used by major car listing services (OLX Autos, CarGurus, Cars.com),
incorporating robust search functions, high-quality photography, push notifications, favorites, and secure communication between buyers and sellers.

✨ Key Features

• Post Vehicle Ads — brand, model, year, mileage, fuel, transmission, condition, price, and more.
• Multi-Image Upload — supports gallery/camera with compression.
• Real-Time Chat — private messaging between buyers and sellers.
• Location-Based Search — map view & geo-distance filters.
• Advanced Filters — body type, engine size, fuel type, features, year range, price range, and custom attributes.
• Favorites / Wishlist — quick save for later browsing.
• User Profiles — manage listings, profile info, ratings (if enabled).
• Push Notifications — chat alerts, listing approvals, offers, expirations.
• Report / Block User tools.
• Admin Approval for new ads, edits, and media.
• Dark & Light Theme support.
• Localization + RTL ready.

⚙️ Technical Stack

• Frontend: Flutter (Dart) — one codebase for Android & iOS.
• Backend: PHP/Laravel REST API or Node.js backend (depending on build).
• Database: MySQL / MariaDB.
• Chat: Firebase Realtime DB / Firestore or API-driven WebSocket chat.
• Push Notifications: Firebase Cloud Messaging.
• Maps & Geolocation: Google Maps API, geocoder & location services.
• Hosting: Linux VPS (Apache/Nginx) or shared hosting with PHP support.
• iOS Requirements: Xcode, macOS, Apple Developer Account.
• Android Requirements: Android Studio, SDK 21+.

🧩 Installation Guide

1. Backend Setup: upload API source → configure .env → run migrations → set file storage & cron jobs.
2. Firebase Setup: create project → enable FCM → download config files → add to app.
3. App Configuration: open Flutter project → update API_BASE_URL → update app ID, name, colors, logos.
4. Maps Integration: add Google Maps keys (Android & iOS).
5. Chat Integration: configure Firebase or WebSocket endpoints.
6. Testing: post sample ads → verify search → verify chat → push to device.
7. Build: flutter build apk / aab for Android; flutter build ipa for iOS.
8. Launch: upload to Play Store / App Store using store guidelines.

📦 Deliverables

• Complete Flutter source code (Android + iOS).
• Backend API (Laravel/Node.js) with SQL database schema.
• Chat module (Firebase or custom API).
• UI/UX screens for listing, posting, map view, user profile, and chat.
• Push notification setup.
• Branding assets (icons, splash screens, images).
• Documentation & installation steps.

📱 Supported Platforms

• Android: Phones/tablets (API 21+).
• iOS: iPhone/iPad (iOS 12+).
• Backend Panel: Chrome, Firefox, Safari, Edge.

🧠 Notes

• License: Redistributed under the GPL license.
• Customization Tips:
  • Add bidding/offers module for negotiated pricing.
  • Introduce premium listings and sponsored ads.
  • Integrate Stripe/PayPal for paid promotions.
  • Add VIN decoder and car history lookup APIs.
  • Enable multi-city or multi-country support via admin settings.
• Security Notes: Ensure secure file uploads, spam controls, and moderated chat for production deployments.
• SEO Optimization: Keywords such as “car classified Flutter app,” “buy/sell vehicle app source code,”
  and “Flutter marketplace v2.6” improve visibility on GPL and template directories.

👨‍💻 Original Developer Credit

Full credit goes to the original developer of Flutter AdMotors.
For commercial licenses, updates, and technical support, please refer to the official listing on
CodeCanyon or the developer’s official website.

🔒 Disclaimer

This package is distributed under the GPL license for educational and archival purposes only.
We are not the original author and do not supply commercial API keys, dealer integrations, VIN services, or marketplace guarantees.
Names of car brands and manufacturers are trademarks of their respective owners.
For production-quality deployments, please purchase from the original developer and comply with automotive data & privacy regulations.