# khderalromi/rentiful_client architecture

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

- Interactive diagram: https://gitdiagram.com/khderalromi/rentiful_client
- Repository: https://github.com/khderalromi/rentiful_client

## Overview

Rentiful is a rental marketplace for tenants and property managers. Tenants discover and filter listings, inspect a residence, and apply or contact its manager; managers create properties and manage applications, properties, and settings. Authentication and shared RTK Query state support these flows, with property and lease operations backed by a configured remote API. Search composition, detail-page children, and selected dashboard dependencies are visible in the source index; unsampled pages limit confidence about their internal calls.

Main entry points: [`state/Auth/AuthSlice.ts`](https://github.com/khderalromi/rentiful_client/blob/main/state/Auth/AuthSlice.ts) (Auth and rental API), [`app/(nondashboard)/search/SearchContent.tsx`](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/SearchContent.tsx) (Search composition), [`app/(nondashboard)/search/[id]/page.tsx`](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/page.tsx) (Residence detail), [`app/(auth)/login/page.tsx`](https://github.com/khderalromi/rentiful_client/blob/main/app/(auth)/login/page.tsx) (Sign in / up)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public marketplace"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_search_page["Search route<br/>[page.tsx]"]
  node_search_content["Search composition<br/>[SearchContent.tsx]"]
  node_filters["Search filters<br/>[FiltersFull.tsx]"]
  node_listing_results["Listing results<br/>[Listings.tsx]"]
  node_map["Map view<br/>[Map.tsx]"]
  node_residence_detail["Residence detail<br/>[page.tsx]"]
  node_application_modal["Application flow"]
  node_contact_widget["Manager contact<br/>[ContactWidget.tsx]"]
end

subgraph group_identity["Identity and API"]
  node_auth_pages["Sign in / up<br/>[page.tsx]"]
  node_auth_api["Auth and rental API<br/>[AuthSlice.ts]"]
  node_remote_service{{"Rentiful server"}}
  node_global_state["Search state<br/>[index.ts]"]
  node_schemas["Property schemas<br/>[schemas.ts]"]
  node_error_messages["API error messages<br/>[errorHandler.ts]"]
end

subgraph group_tenant["Tenant workspace"]
  node_tenant_apps["Tenant applications<br/>[page.tsx]"]
  node_tenant_residences["Tenant residences<br/>[page.tsx]"]
  node_tenant_favourites["Saved properties<br/>[page.tsx]"]
end

subgraph group_manager["Manager workspace"]
  node_manager_create["Create property<br/>[page.tsx]"]
  node_manager_properties["Manage properties<br/>[page.tsx]"]
  node_manager_apps["Review applications<br/>[page.tsx]"]
  node_settings["Account settings<br/>[SettingsForm.tsx]"]
end

node_visitor(("Visitor / renter"))
node_manager_actor(("Property manager"))

node_visitor -->|"browses"| node_landing
node_visitor -.->|"searches"| node_search_page
node_search_page -->|"renders"| node_search_content
node_search_content -->|"renders"| node_filters
node_search_content -->|"renders"| node_listing_results
node_search_content -->|"renders"| node_map
node_search_content -->|"uses filters"| node_global_state
node_listing_results -.->|"opens listing"| node_residence_detail
node_residence_detail -->|"renders"| node_application_modal
node_residence_detail -->|"renders"| node_contact_widget
node_visitor -->|"authenticates"| node_auth_pages
node_auth_pages -->|"calls mutations"| node_auth_api
node_auth_pages -->|"formats errors"| node_error_messages
node_manager_actor -.->|"creates listing"| node_manager_create
node_manager_create -->|"creates property"| node_auth_api
node_manager_create -->|"validates input"| node_schemas
node_manager_apps -->|"uses API state"| node_auth_api
node_tenant_apps -->|"uses API state"| node_auth_api
node_tenant_residences -->|"uses API state"| node_auth_api
node_manager_properties -->|"uses API state"| node_auth_api
node_settings -->|"validates settings"| node_schemas
node_auth_api -->|"sends requests"| node_remote_service
node_auth_api -->|"uses property types"| node_global_state

click node_landing "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/landing/page.tsx"
click node_search_page "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/page.tsx"
click node_search_content "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/SearchContent.tsx"
click node_filters "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/FiltersFull.tsx"
click node_listing_results "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/Listings.tsx"
click node_map "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/Map.tsx"
click node_residence_detail "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/page.tsx"
click node_application_modal "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/ApplicationModal.tsx"
click node_contact_widget "https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/ContactWidget.tsx"
click node_auth_pages "https://github.com/khderalromi/rentiful_client/blob/main/app/(auth)/login/page.tsx"
click node_auth_api "https://github.com/khderalromi/rentiful_client/blob/main/state/Auth/AuthSlice.ts"
click node_tenant_apps "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/applications/page.tsx"
click node_tenant_residences "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/residences/%5Bid%5D/page.tsx"
click node_tenant_favourites "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/favourites/page.tsx"
click node_manager_create "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/newProperty/page.tsx"
click node_manager_properties "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/properties/%5Bid%5D/page.tsx"
click node_manager_apps "https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/applications/page.tsx"
click node_settings "https://github.com/khderalromi/rentiful_client/blob/main/components/SettingsForm.tsx"
click node_global_state "https://github.com/khderalromi/rentiful_client/blob/main/state/index.ts"
click node_schemas "https://github.com/khderalromi/rentiful_client/blob/main/lib/schemas.ts"
click node_error_messages "https://github.com/khderalromi/rentiful_client/blob/main/lib/error/errorHandler.ts"

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_landing,node_search_page,node_search_content,node_filters,node_listing_results,node_map,node_residence_detail,node_application_modal,node_contact_widget toneBlue
class node_auth_pages,node_auth_api,node_remote_service,node_global_state,node_schemas,node_error_messages toneAmber
class node_tenant_apps,node_tenant_residences,node_tenant_favourites toneMint
class node_manager_create,node_manager_properties,node_manager_apps,node_settings toneRose
class node_visitor,node_manager_actor toneIndigo
```

## Components

### Public marketplace

- [Landing page](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/landing/page.tsx): `app/(nondashboard)/landing/page.tsx`
- [Search route](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/page.tsx): `app/(nondashboard)/search/page.tsx`
- [Search composition](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/SearchContent.tsx): `app/(nondashboard)/search/SearchContent.tsx`
- [Search filters](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/FiltersFull.tsx): `app/(nondashboard)/search/FiltersFull.tsx`
- [Listing results](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/Listings.tsx): `app/(nondashboard)/search/Listings.tsx`
- [Map view](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/Map.tsx): `app/(nondashboard)/search/Map.tsx`
- [Residence detail](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/page.tsx): `app/(nondashboard)/search/[id]/page.tsx`
- [Application flow](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/ApplicationModal.tsx): `app/(nondashboard)/search/[id]/ApplicationModal.tsx`
- [Manager contact](https://github.com/khderalromi/rentiful_client/blob/main/app/(nondashboard)/search/%5Bid%5D/ContactWidget.tsx): `app/(nondashboard)/search/[id]/ContactWidget.tsx`

### Identity and API

- [Sign in / up](https://github.com/khderalromi/rentiful_client/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Auth and rental API](https://github.com/khderalromi/rentiful_client/blob/main/state/Auth/AuthSlice.ts): `state/Auth/AuthSlice.ts`
- **Rentiful server**
- [Search state](https://github.com/khderalromi/rentiful_client/blob/main/state/index.ts): `state/index.ts`
- [Property schemas](https://github.com/khderalromi/rentiful_client/blob/main/lib/schemas.ts): `lib/schemas.ts`
- [API error messages](https://github.com/khderalromi/rentiful_client/blob/main/lib/error/errorHandler.ts): `lib/error/errorHandler.ts`

### Tenant workspace

- [Tenant applications](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/applications/page.tsx): `app/(dashboard)/tenants/applications/page.tsx`
- [Tenant residences](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/residences/%5Bid%5D/page.tsx): `app/(dashboard)/tenants/residences/[id]/page.tsx`
- [Saved properties](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/tenants/favourites/page.tsx): `app/(dashboard)/tenants/favourites/page.tsx`

### Manager workspace

- [Create property](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/newProperty/page.tsx): `app/(dashboard)/managers/newProperty/page.tsx`
- [Manage properties](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/properties/%5Bid%5D/page.tsx): `app/(dashboard)/managers/properties/[id]/page.tsx`
- [Review applications](https://github.com/khderalromi/rentiful_client/blob/main/app/(dashboard)/managers/applications/page.tsx): `app/(dashboard)/managers/applications/page.tsx`
- [Account settings](https://github.com/khderalromi/rentiful_client/blob/main/components/SettingsForm.tsx): `components/SettingsForm.tsx`

### Other components

- **Visitor / renter**
- **Property manager**

## Connections

- Visitor / renter → Landing page: browses
- Visitor / renter → Search route: searches
- Search route → Search composition: renders (evidence: `app/(nondashboard)/search/page.tsx`)
- Search composition → Search filters: renders (evidence: `app/(nondashboard)/search/SearchContent.tsx`)
- Search composition → Listing results: renders (evidence: `app/(nondashboard)/search/SearchContent.tsx`)
- Search composition → Map view: renders (evidence: `app/(nondashboard)/search/SearchContent.tsx`)
- Search composition → Search state: uses filters (evidence: `app/(nondashboard)/search/SearchContent.tsx`)
- Listing results → Residence detail: opens listing
- Residence detail → Application flow: renders (evidence: `app/(nondashboard)/search/[id]/page.tsx`)
- Residence detail → Manager contact: renders (evidence: `app/(nondashboard)/search/[id]/page.tsx`)
- Visitor / renter → Sign in / up: authenticates (evidence: `app/(auth)/login/page.tsx`)
- Sign in / up → Auth and rental API: calls mutations (evidence: `app/(auth)/login/page.tsx`)
- Sign in / up → API error messages: formats errors (evidence: `app/(auth)/login/page.tsx`)
- Property manager → Create property: creates listing
- Create property → Auth and rental API: creates property (evidence: `app/(dashboard)/managers/newProperty/page.tsx`)
- Create property → Property schemas: validates input (evidence: `app/(dashboard)/managers/newProperty/page.tsx`)
- Review applications → Auth and rental API: uses API state (evidence: `app/(dashboard)/managers/applications/page.tsx`)
- Tenant applications → Auth and rental API: uses API state (evidence: `app/(dashboard)/tenants/applications/page.tsx`)
- Tenant residences → Auth and rental API: uses API state (evidence: `app/(dashboard)/tenants/residences/[id]/page.tsx`)
- Manage properties → Auth and rental API: uses API state (evidence: `app/(dashboard)/managers/properties/[id]/page.tsx`)
- Account settings → Property schemas: validates settings (evidence: `app/(dashboard)/managers/settings/page.tsx`)
- Auth and rental API → Rentiful server: sends requests (evidence: `state/Auth/AuthSlice.ts`)
- Auth and rental API → Search state: uses property types (evidence: `state/Auth/AuthSlice.ts`)
