HomListi – Real Estate Listing Android & iOS App

✨ Key Features

• Comprehensive property listings: Add, edit, and manage properties with price, location, amenities, size, images, and video tours.
• Multi-vendor support: Agents and agencies can register, post, and manage their listings independently.
• Advanced search & filters: Filter by price, type, city, bedrooms, bathrooms, or amenities.
• Map integration: Interactive map view with Google Maps or MapBox APIs to locate properties visually.
• Favorites & compare: Users can save favorite listings and compare multiple properties side-by-side.
• Authentication system: Email/password, Google, or Apple Sign-In options via Firebase Auth or custom JWT.
• In-app chat: Buyer-seller direct messaging with real-time updates (Firebase or Pusher backend).
• Push notifications: New listings, offers, and messages delivered via FCM.
• AdMob integration: Banner and interstitial ads for monetization.
• Dynamic categories: Apartments, houses, plots, offices, villas, commercial spaces, etc.
• Multi-language & RTL: Support for Arabic, French, Spanish, and more; full RTL layout included.
• Dark/Light theme: Auto theme switching with adaptive color schemes.
• Offline mode: Cached search results and saved listings accessible without internet.
• Admin panel: Laravel backend with roles, analytics, reports, and moderation tools.

⚙️ Technical Stack

• Frontend: Flutter 3.x (null-safe, cross-platform for Android & iOS)
• Backend: Laravel 10+ (PHP 8.1+) REST API
• Database: MySQL 8 / MariaDB 10.6+
• APIs: Google Maps / MapBox, Firebase Messaging, AdMob SDK
• Authentication: JWT / OAuth2 with Laravel Sanctum
• File Storage: Local / AWS S3 / DigitalOcean Spaces
• Search Engine: Laravel Scout / Algolia (optional)
• State Management: Riverpod / Provider / BLoC pattern
• Push Notifications: Firebase Cloud Messaging (FCM)
• Server Requirements: PHP 8.1+, Composer, Node 18+, HTTPS, and 1 GB+ RAM for hosting

🧩 Installation Guide

1. Backend setup: Upload Laravel files, run composer install, php artisan migrate --seed.
2. Configure .env: Set database credentials, APP_URL, API keys (Google Maps, Firebase, AdMob).
3. Admin setup: Create an admin user via php artisan tinker or seeders.
4. Flutter app: Open the project in Android Studio or VS Code and run flutter pub get.
5. Update endpoints: Set BASE_URL and API keys in lib/config/.
6. Branding: Replace app name, icons, splash screen, and color palette.
7. Testing: Run on devices/emulators; check listings, login, and chat functions.
8. Deployment: Build a signed AAB/IPA and deploy backend with SSL-enabled domain.

📦 Deliverables

• Full Flutter app source code (Android & iOS)
• Laravel backend with REST API + Admin panel
• SQL schema, seed data (categories, users, demo properties)
• Config & environment templates (.env.example, config.dart)
• Documentation: setup, API usage, publishing, and maintenance guide
• GPL license file & redistribution notice

📱 Supported Platforms

• Android: API 23 (Android 6.0) and above
• iOS: iOS 13 and above
• Web (optional): Supported via Flutter Web build (beta)

🧠 Notes & Licensing

• License: Distributed under the GPL for educational and derivative works.
• Customization tips: Modularize property filters, integrate Algolia or MeiliSearch for fast search, and use AWS S3 for image delivery.
• Performance: Implement lazy-loading for images, paginate API calls, and enable database caching.
• Compliance: Include privacy policy and data-protection notice; validate property submissions and user uploads.
• Store SEO: Use keywords like “real estate app,” “property finder,” “buy rent house,” and “Flutter property listing.”

👨‍💻 Original Developer Credit

This description acknowledges the original “HomListi” developer(s) published on
CodeCanyon.
Please support the original author if you rely on their commercial edition or require updates and technical support.

🔒 Disclaimer

This source code is provided for educational and evaluation purposes under the GPL.
You must configure your own Firebase, AdMob, and Google Maps API keys.
Any demo content, images, or trademarks remain the property of their respective owners.
Ensure compliance with real-estate data, privacy, and advertising laws before deployment. No demo links are included.