HomeVZ - Kenya Housing Solution Platform

A comprehensive cross-platform mobile application built with Flutter that addresses housing challenges in Kenya. HomeVZ connects tenants with landlords, provides property management tools, integrates M-Pesa payments, and offers real estate services.

🏠 Features

For Tenants

• Property Discovery: Browse verified rental properties across Kenya
• Advanced Search: Filter by location, price, amenities, and property type
• Virtual Tours: View property images and details
• Secure Payments: Pay rent and deposits via M-Pesa integration
• Tenant Portal: Track payments, maintenance requests, and lease information

For Landlords

• Property Listing: Easy property listing with image uploads
• Tenant Management: Screen tenants, track applications, and manage leases
• Payment Tracking: Monitor rent payments and generate financial reports
• Maintenance Management: Handle tenant requests and track property maintenance
• Analytics Dashboard: Insights on property performance and rental income

For Real Estate

• Land Sales & Leasing: Browse plots across Kenya with verified documentation
• Investment Opportunities: Discover land for development or investment
• Market Analysis: Property market trends and pricing insights

Financial Services

• M-Pesa Integration: Seamless mobile money transactions
• Loan Services: Access to property expansion and rental loans
• Payment History: Comprehensive transaction records
• Rental Insurance: Property protection services

🚀 Technology Stack

• Frontend: Flutter (Cross-platform for iOS, Android, Web)
• State Management: Riverpod
• Architecture: Clean Architecture with Feature-First approach
• Local Storage: Hive & Shared Preferences
• Networking: Dio & HTTP client
• Authentication: Firebase Auth with Google Sign-In
• Maps: Google Maps Flutter
• Payments: Custom M-Pesa API Integration
• Image Handling: Cached Network Image & Image Picker

📱 Supported Platforms

• ✅ Android
• ✅ iOS
• ✅ Web

🛠️ Getting Started

Prerequisites

• Flutter SDK (latest stable version)
• Dart SDK
• Android Studio / VS Code
• Git

Installation

1. Install dependencies

   flutter pub get

2. Run the app

   flutter run

Development Setup

1. Install VS Code Extensions

   • Flutter
   • Dart

2. Configure IDE

   • Enable Flutter hot reload
   • Set up debugging configuration

🧪 Testing

Run tests using the following commands:

# Unit tests
flutter test

# Integration tests
flutter test integration_test/

🌍 Localization

The app supports multiple languages:

• English (default)
• Swahili (Kiswahili)

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

• Kenyan housing market research and insights
• Local community feedback and requirements
• Open source Flutter community
• M-Pesa API documentation and support

---

Made with ❤️ for Kenya's housing sector