🚀 Overview

onProperty is a production-ready Flutter real estate app template for Android & iOS. It delivers the essential flows for
discovering, listing, and inquiring about properties: map & list search, rich detail pages, image galleries, favorite saves,
agent chat, and viewing requests. It’s ideal for agencies, brokers, and startups launching a branded real estate marketplace or a
single-agency app with modern UX.

Experience (E): The template mirrors real-world property funnels—geo search, price/bed filters, photo-first detail pages, lead capture, and
appointment scheduling—validated by common brokerage workflows to minimize friction from discovery to viewing.

✨ Key Features

• 🏠 Listings Catalog: Cards with price, beds/baths, area, status (rent/sale), and verified badges.
• 🗺️ Map + List Search: Google Maps integration with clustering, draw-on-map (optional), and nearby sorting.
• 🎯 Power Filters: Price range, bedrooms, bathrooms, property type, amenities, furnishing, and radius.
• 🖼️ Galleries & Media: Swipeable photo gallery, full-screen viewer, and video/virtual-tour placeholders.
• 💬 Lead & Chat: In-app messaging with typing indicators, quick replies, and call/WhatsApp actions.
• 📅 Book a Viewing: Date/time slot picker with agent assignment and push confirmations.
• ⭐ Favorites & Alerts: Save searches, get notifications for new matches and price drops.
• 🌍 i18n & RTL: Multi-language support, RTL layouts, currency & unit localization (m²/ft²).
• 🧩 Clean Architecture: Modular features, repository pattern, and testable state management.
• 🛡️ Trust & Safety: Report listing, basic moderation hooks, and image/size validations.

⚙️ Technical Stack (Expertise)

• Framework: Flutter 3.x (Dart 3, Material 3, null safety)
• State Management: Riverpod/BLoC examples (switchable)
• Networking: Dio/HTTP with interceptors, retry, and pagination
• Maps & Geo: Google Maps SDK + Geocoding/Places (pluggable)
• Auth: Email/phone/OAuth (JWT-ready stubs)
• Backend (pluggable): Laravel 10 REST / Firebase / WordPress JSON API (samples provided)
• Storage: Firebase Storage or S3-compatible object storage (signed URLs)
• Notifications: Firebase Cloud Messaging (FCM)
• Build Requirements: Android SDK 26+, Xcode 15+, Flutter stable channel

🧩 Installation Guide

1. Clone the project and run flutter pub get.
2. Set API_BASE_URL, Maps & FCM keys in lib/config/app_config.dart.
3. (Optional) Deploy the sample Laravel/Firebase backend and import seed data.
4. Enable Google Maps keys in AndroidManifest.xml and AppDelegate.swift.
5. Customize theme colors, logos, and strings (lib/theme, assets/).
6. Run flutter run → build releases with flutter build apk / flutter build ios.

📦 Deliverables

• ✅ Complete Flutter source (Android & iOS)
• ✅ Listing, search, filters, detail, chat, and booking screens
• ✅ Reusable services (auth, API client, storage, notifications)
• ✅ Sample backend stubs (Laravel/Firebase) + Postman collection
• ✅ Theming assets, icons, and localization templates
• ✅ Documentation & GPL v3 license file

📱 Supported Platforms

• Android: 8.0 (API 26)+ phones & tablets
• iOS: 13+ (Universal iPhone/iPad)
• Server: Ubuntu 22.04+ / cPanel / Docker-ready (if using Laravel)

👨‍💻 Original Developer Credit (Authoritativeness)

This package credits the original commercial author. Please support them on their marketplace profile:
CodeCanyon – Original Author.

🔒 Disclaimer (Trustworthiness)

This listing redistributes software under the GPL v3. We are not affiliated with any real estate brand or MLS.
Ensure compliance with local real estate advertising laws, fair housing guidelines, and app-store policies.
Always enable HTTPS, protect API keys, and moderate user-generated listings before going live.