# bahlenx/accommodation-seeking-app architecture

> Architecture diagram of the GitHub repository bahlenx/accommodation-seeking-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bahlenx/accommodation-seeking-app
- Repository: https://github.com/bahlenx/accommodation-seeking-app

## Overview

iKhaya is a native Android accommodation and rental-workflow app for tenants, landlords, and administrators. The main user journey is account access, property discovery and review, then rental applications, enquiries, or viewings; landlords manage listings and administrators review them. The README documents Supabase-backed authentication, database access, and image storage, plus messaging, maps, and language settings. Source excerpts do not include Java implementation, so relationships below rely on those README statements; unsampled wiring is omitted.

Main entry points: [`app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java`](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java) (Property details), [`app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LandlordDashboardActivity.java`](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LandlordDashboardActivity.java) (Landlord dashboard), [`app/src/main/java/com/example/ikhaya_accommodation_seeking_app/RegistrationActivity.java`](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/RegistrationActivity.java) (Registration), [`app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LoginActivity.java`](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LoginActivity.java) (Sign in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and profiles"]
  node_entry["Account entry"]
  node_registration["Registration"]
  node_login["Sign in<br/>[LoginActivity.java]"]
  node_verification["OTP verification<br/>[OtpActivity.java]"]
  node_profile["Tenant profile"]
  node_language["Language settings"]
end

subgraph group_tenant["Tenant discovery"]
  node_home["Home feed<br/>[HomeActivity.java]"]
  node_search["Property search"]
  node_details["Property details"]
  node_saved["Saved listings"]
  node_applications["Rental applications"]
  node_viewings["Viewing requests"]
  node_map["Property maps"]
end

subgraph group_landlord["Landlord tools"]
  node_landlord["Landlord dashboard"]
  node_listing_create["Create listing"]
  node_listing_edit["Edit listing"]
  node_listing_manage["Manage listings"]
end

subgraph group_operations["Administration and communication"]
  node_admin["Admin dashboard"]
  node_review["Listing review"]
  node_chat["Direct messaging<br/>[ChatActivity.java]"]
  node_community["Community conversation"]
end

subgraph group_backend["Backend and shared logic"]
  node_supabase["Supabase services"]
  node_helper["Backend requests"]
  node_applications_logic["Application operations"]
  node_listing_logic["Listing operations"]
end

node_seeker(("App user"))

node_seeker -->|"opens app"| node_entry
node_seeker -->|"registers"| node_registration
node_seeker -->|"signs in"| node_login
node_registration -->|"verifies OTP"| node_verification
node_login -->|"authenticates"| node_supabase
node_registration -->|"creates account"| node_supabase
node_seeker -->|"discovers homes"| node_home
node_home -->|"searches listings"| node_search
node_search -->|"opens property"| node_details
node_details -->|"saves favourite"| node_saved
node_details -->|"applies to rent"| node_applications
node_details -->|"requests viewing"| node_viewings
node_seeker -->|"manages rentals"| node_landlord
node_landlord -->|"creates listing"| node_listing_create
node_landlord -->|"edits listing"| node_listing_edit
node_landlord -->|"manages listings"| node_listing_manage
node_listing_create -->|"uploads images"| node_supabase
node_seeker -->|"administers platform"| node_admin
node_admin -->|"reviews queue"| node_review
node_seeker -->|"messages users"| node_chat
node_seeker -->|"joins conversation"| node_community
node_chat -->|"sends and retrieves"| node_supabase
node_helper -->|"makes REST requests"| node_supabase
node_applications_logic -.->|"application operations"| node_supabase
node_listing_logic -.->|"listing operations"| node_supabase
node_details -->|"shows location"| node_map
node_seeker -->|"sets language"| node_language

click node_entry "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OuterMainActivity.java"
click node_registration "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/RegistrationActivity.java"
click node_login "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LoginActivity.java"
click node_verification "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OtpActivity.java"
click node_profile "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/TenantProfileActivity.java"
click node_home "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/HomeActivity.java"
click node_search "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SearchResultsActivity.java"
click node_details "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java"
click node_saved "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SavedListingsActivity.java"
click node_applications "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationsActivity.java"
click node_viewings "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ViewingsActivity.java"
click node_landlord "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LandlordDashboardActivity.java"
click node_listing_create "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AddListingActivity.java"
click node_listing_edit "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/EditListingActivity.java"
click node_listing_manage "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/MyListingsActivity.java"
click node_admin "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminDashboardActivity.java"
click node_review "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminPendingQueueActivity.java"
click node_chat "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ChatActivity.java"
click node_community "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/UserSelectionActivity.java"
click node_helper "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SupabaseHelper.java"
click node_applications_logic "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationManager.java"
click node_listing_logic "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ListingManager.java"
click node_map "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java"
click node_language "https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LanguageSettingsActivity.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_registration,node_login,node_verification,node_profile,node_language,node_seeker toneBlue
class node_home,node_search,node_details,node_saved,node_applications,node_viewings,node_map toneAmber
class node_landlord,node_listing_create,node_listing_edit,node_listing_manage toneMint
class node_admin,node_review,node_chat,node_community toneRose
class node_supabase,node_helper,node_applications_logic,node_listing_logic toneIndigo
```

## Components

### Accounts and profiles

- [Account entry](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OuterMainActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OuterMainActivity.java`
- [Registration](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/RegistrationActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/RegistrationActivity.java`
- [Sign in](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LoginActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LoginActivity.java`
- [OTP verification](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OtpActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/OtpActivity.java`
- [Tenant profile](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/TenantProfileActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/TenantProfileActivity.java`
- [Language settings](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LanguageSettingsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LanguageSettingsActivity.java`

### Tenant discovery

- [Home feed](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/HomeActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/HomeActivity.java`
- [Property search](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SearchResultsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SearchResultsActivity.java`
- [Property details](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java`
- [Saved listings](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SavedListingsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SavedListingsActivity.java`
- [Rental applications](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationsActivity.java`
- [Viewing requests](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ViewingsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ViewingsActivity.java`
- [Property maps](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/PropertyDetailsActivity.java`

### Landlord tools

- [Landlord dashboard](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LandlordDashboardActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/LandlordDashboardActivity.java`
- [Create listing](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AddListingActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AddListingActivity.java`
- [Edit listing](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/EditListingActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/EditListingActivity.java`
- [Manage listings](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/MyListingsActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/MyListingsActivity.java`

### Administration and communication

- [Admin dashboard](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminDashboardActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminDashboardActivity.java`
- [Listing review](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminPendingQueueActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/AdminPendingQueueActivity.java`
- [Direct messaging](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ChatActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ChatActivity.java`
- [Community conversation](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/UserSelectionActivity.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/UserSelectionActivity.java`

### Backend and shared logic

- **Supabase services**
- [Backend requests](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SupabaseHelper.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/SupabaseHelper.java`
- [Application operations](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationManager.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ApplicationManager.java`
- [Listing operations](https://github.com/bahlenx/accommodation-seeking-app/blob/main/app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ListingManager.java): `app/src/main/java/com/example/ikhaya_accommodation_seeking_app/ListingManager.java`

### Other components

- **App user**

## Connections

- App user → Account entry: opens app (evidence: `README.md`)
- App user → Registration: registers (evidence: `README.md`)
- App user → Sign in: signs in (evidence: `README.md`)
- Registration → OTP verification: verifies OTP (evidence: `README.md`)
- Sign in → Supabase services: authenticates (evidence: `README.md`)
- Registration → Supabase services: creates account (evidence: `README.md`)
- App user → Home feed: discovers homes (evidence: `README.md`)
- Home feed → Property search: searches listings (evidence: `README.md`)
- Property search → Property details: opens property (evidence: `README.md`)
- Property details → Saved listings: saves favourite (evidence: `README.md`)
- Property details → Rental applications: applies to rent (evidence: `README.md`)
- Property details → Viewing requests: requests viewing (evidence: `README.md`)
- App user → Landlord dashboard: manages rentals (evidence: `README.md`)
- Landlord dashboard → Create listing: creates listing (evidence: `README.md`)
- Landlord dashboard → Edit listing: edits listing (evidence: `README.md`)
- Landlord dashboard → Manage listings: manages listings (evidence: `README.md`)
- Create listing → Supabase services: uploads images (evidence: `README.md`)
- App user → Admin dashboard: administers platform (evidence: `README.md`)
- Admin dashboard → Listing review: reviews queue (evidence: `README.md`)
- App user → Direct messaging: messages users (evidence: `README.md`)
- App user → Community conversation: joins conversation (evidence: `README.md`)
- Direct messaging → Supabase services: sends and retrieves (evidence: `README.md`)
- Backend requests → Supabase services: makes REST requests (evidence: `README.md`)
- Application operations → Supabase services: application operations
- Listing operations → Supabase services: listing operations
- Property details → Property maps: shows location (evidence: `README.md`)
- App user → Language settings: sets language (evidence: `README.md`)
