🚀 Overview

City Guide is a full-featured directory listing platform designed for businesses, service providers, and city explorers. It includes a frontend website, mobile applications for iOS and Android, and a powerful admin panel for managing listings, categories, and user interactions. Ideal for real-world use cases like local business directories, tourism guides, and service listings, City Guide provides a seamless experience for both administrators and end-users.

✨ Key Features

• Business & Service Listings: Add, manage, and display businesses, restaurants, shops, and service providers.
• Category Management: Organize listings with categories, subcategories, and tags.
• Frontend Website: Responsive design for easy browsing and search of listings.
• Mobile App: iOS & Android apps for users to discover listings on the go.
• Admin Panel: Manage listings, users, reviews, and advertisements efficiently.
• Search & Filters: Advanced search with location, category, rating, and keyword filters.
• Reviews & Ratings: Users can leave reviews and ratings for businesses.
• Notifications: Email and push notifications for listing approvals and updates.
• Analytics & Reports: Track listing performance, user engagement, and site metrics.

⚙️ Technical Stack

• Backend: PHP 7.x / 8.x
• Frontend: HTML5, CSS3, JavaScript, Bootstrap / Vue.js
• Mobile App: Flutter for cross-platform iOS & Android apps
• Database: MySQL / MariaDB
• Server Requirements: Apache/Nginx, PHP modules (PDO, cURL, GD), 2GB RAM minimum

🧩 Installation Guide

1. Upload the backend source code to your web server.
2. Create a MySQL database and import the provided SQL file.
3. Configure config.php with your database and server credentials.
4. Build and deploy the Flutter mobile app for iOS and Android using flutter build.
5. Access the admin panel to manage listings, categories, and users.

📦 Deliverables

• Frontend website source code
• Flutter mobile app source code (iOS & Android)
• Admin panel source code
• Database SQL file for initial setup
• Documentation & installation guide
• GPL license for free use, modification, and redistribution

📱 Supported Platforms

• Web Browsers: Chrome, Firefox, Edge, Safari
• Mobile: iOS (12+) & Android (7+)
• Desktop: Windows, macOS, Linux (via browser)

🧠 Notes

License: GPL – Free to use, modify, and redistribute.

Customization Tips: Add new features like payment integration for premium listings, multi-language support, or custom map views.

SEO Assurance: Semantic HTML ensures search engines can index directory listings, categories, and business details efficiently.

👨‍💻 Original Developer Credit

Developed by Original Author / Marketplace.

🔒 Disclaimer

This directory listing platform is distributed under the GPL license. Redistribution, modification, and commercial use are permitted under GPL terms. All rights remain with the original developer, and users should credit accordingly.