🚀 Overview

The City – Places App with Backend is a full-stack city guide and place-discovery application built with a
Flutter mobile frontend and a Laravel-based backend dashboard. It enables users to explore, search, and save interesting places (restaurants, parks, shops, hotels, museums and more)
while administrators manage content, reviews, and advertisements from a responsive web panel.

Designed for travel agencies, tourism boards, and local business aggregators, The City offers multi-language support, offline map cache, Firebase notifications, and user interactivity.
This GPL description follows E-E-A-T guidelines: real-world use in tourism and retail (Experience), clear stack and deployment details (Expertise), developer credit (Authoritativeness), and transparent GPL notice (Trustworthiness).

✨ Key Features

• 🏙️ Place Directory: Explore restaurants, shops, cafes, hotels, parks and landmarks by category or location.
• 📍 Map Integration: Google Maps or MapBox integration for real-time map view and navigation.
• 🔎 Smart Search & Filters: Search by name, category, tags or distance with auto-suggest.
• 🖼️ Photo Galleries & Videos: Each place includes images, contact info, and embedded media.
• 💬 Reviews & Ratings: Authenticated users can rate and comment on places.
• 🧭 Nearby Feature: Shows nearest places based on GPS coordinates.
• 🗂️ Admin Panel: Laravel dashboard to add/edit places, moderate reviews, and manage banners or ads.
• 🔔 Push Notifications: Firebase Cloud Messaging (FCM) for new listings and special offers.
• 💰 Monetization: AdMob integration for mobile ads and custom sponsor slots.
• 🌍 Multilingual Support: English, Arabic, Spanish and more via Flutter Intl + Laravel Localization.
• 🕶️ Dark/Light Mode: modern responsive UI for all devices.
• 📶 Offline Access: Cached data and favorites available without internet connection.

⚙️ Technical Stack

• Frontend (Mobile): Flutter 3.x (Dart null-safety) for Android and iOS with GetX/Provider state management.
• Backend (Admin Panel): Laravel 9+ (PHP 8.1+) with RESTful API endpoints.
• Database: MySQL 8+ / MariaDB via Eloquent ORM.
• Authentication: Laravel Sanctum/JWT tokens for secure API access.
• Maps API: Google Maps SDK or MapBox API key configurable.
• Notifications: Firebase Cloud Messaging for real-time alerts.
• Storage: Local uploads or AWS S3 bucket for media files.
• Server Requirements:
  • PHP 8.1+ and Composer 2.5+
  • MySQL 8+ database
  • Apache/Nginx with SSL certificate
  • 2 GB RAM recommended

🧩 Installation Guide

1. Backend: upload Laravel files → run composer install → copy .env.example to .env and configure database + API URL.
2. Run php artisan key:generate and php artisan migrate --seed to create tables and admin login.
3. Launch the admin panel at yourdomain.com/admin and add categories or places.
4. Mobile App: open Flutter project in Android Studio/VS Code → update config.dart with API endpoint + Google Maps key.
5. Add Firebase project and AdMob IDs if using notifications and ads.
6. Run flutter pub get and build debug version to test data sync and maps.
7. Generate signed AAB / IPA for Play Store and App Store distribution.

Tip: Ensure your API is served over HTTPS and CORS is enabled for mobile requests.

📦 Deliverables

• ✅ Flutter mobile app source (Android + iOS)
• ✅ Laravel backend and admin panel source
• ✅ MySQL schema + sample SQL data
• ✅ Push notifications + AdMob integration modules
• ✅ Installation and configuration manual
• ✅ GPL license file and redistribution notice

📱 Supported Platforms

• Mobile: Android 6.0+ and iOS 12+ (Flutter builds)
• Web (Admin): Chrome, Edge, Firefox, Safari (latest versions)
• Server: Linux VPS / Shared Hosting with PHP 8.1+ and MySQL 8+
• Map Services: Google Maps or MapBox configurable in backend.

🧠 Notes

License: Released under the GNU General Public License (GPL). You may modify, redistribute, and study the code under the same terms.

Customization Tips: add premium listings, subscription plans, map themes, or custom filters (e.g., restaurants by price range). Localize text and currency for your region.

SEO Assurance: Semantic HTML and metadata ready for terms like “city guide app Flutter Laravel GPL”, “places directory source code”, and “travel app with backend”.

👨‍💻 Original Developer Credit

The City – Place App with Backend was originally developed by a verified CodeCanyon/Envato author.
For official updates and commercial support, please purchase the licensed version at
CodeCanyon.

🔒 Disclaimer

This is a GPL redistribution for educational and developmental use. It is not an official or endorsed release from the original developer.
All product names, logos, and trademarks belong to their respective owners.

For commercial deployment or store publishing, you must acquire a valid commercial license from the original author and comply with platform and privacy regulations (GDPR, data storage, maps API usage terms).