# shadrackb1/unihubke architecture

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

- Interactive diagram: https://gitdiagram.com/shadrackb1/unihubke
- Repository: https://github.com/shadrackb1/unihubke

## Overview

UniHub KE is a student-housing discovery and management application. The main user flow is browsing or searching listings and hostel details; landlords and administrators manage housing data and media through separate dashboards. Firestore provides the documented domain data layer, Firebase supplies authentication, and Cloudinary handles media uploads. The README also names maps and a master-operator dashboard; their routes or implementations are only partly sampled, so those branches are included with limited or unverified links.

Main entry points: [`src/services/firestore.ts`](https://github.com/shadrackb1/unihubke/blob/main/src/services/firestore.ts) (Firestore services), [`src/App.tsx`](https://github.com/shadrackb1/unihubke/blob/main/src/App.tsx) (Application routes), [`src/pages/admin/AdminDashboard.tsx`](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminDashboard.tsx) (Admin workspace), [`src/lib/storage.ts`](https://github.com/shadrackb1/unihubke/blob/main/src/lib/storage.ts) (Media upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Housing discovery"]
  node_app["Application routes<br/>[App.tsx]"]
  node_search["University search<br/>[HeroSearch.tsx]"]
  node_listing["Listing browse<br/>[ListingsPage.tsx]"]
  node_property["Property details"]
  node_hostels["Hostel browse<br/>[HostelsPage.tsx]"]
  node_hostel["Hostel details"]
  node_maps["Listing maps<br/>[Map.tsx]"]
end

subgraph group_management["Housing management"]
  node_landlord["Landlord dashboard"]
  node_admin["Admin workspace<br/>[AdminDashboard.tsx]"]
  node_propertyadmin["Property management"]
  node_hosteladmin["Hostel management"]
  node_roomadmin["Room management"]
end

subgraph group_operations["Platform operations"]
  node_cms["Site CMS<br/>[AdminCMSPage.tsx]"]
  node_agents["Agent management"]
  node_universities["University management"]
  node_mediaadmin["Media manager"]
  node_master["Master dashboard"]
end

subgraph group_services["Shared services"]
  node_auth["User authentication<br/>[AuthContext.tsx]"]
  node_firestore["Firestore services<br/>[firestore.ts]"]
  node_firebase["Firebase setup<br/>[firebase.ts]"]
  node_upload["Media upload<br/>[storage.ts]"]
end

node_visitor(("Housing seeker"))
node_cloudinary[("Cloudinary")]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_listing
node_app -->|"routes to"| node_property
node_app -->|"routes to"| node_hostels
node_app -->|"routes to"| node_hostel
node_app -->|"routes to"| node_admin
node_search -->|"reads universities"| node_firebase
node_listing -->|"loads listings"| node_firestore
node_property -->|"loads details"| node_firestore
node_hostel -->|"loads hostel"| node_firestore
node_listing -.->|"displays locations"| node_maps
node_landlord -->|"manages listings"| node_firestore
node_admin -.->|"routes to"| node_propertyadmin
node_admin -.->|"routes to"| node_hosteladmin
node_admin -.->|"routes to"| node_roomadmin
node_propertyadmin -->|"writes properties"| node_firestore
node_hosteladmin -->|"writes hostels"| node_firestore
node_roomadmin -->|"writes rooms"| node_firestore
node_cms -->|"saves settings"| node_firestore
node_agents -->|"manages agents"| node_firestore
node_universities -->|"manages universities"| node_firestore
node_mediaadmin -->|"uploads media"| node_upload
node_landlord -->|"uploads media"| node_upload
node_cms -.->|"uploads media"| node_upload
node_upload -->|"sends uploads"| node_cloudinary
node_firestore -->|"uses database"| node_firebase
node_auth -->|"uses authentication"| node_firebase
node_master -.->|"manages platform"| node_firestore

click node_app "https://github.com/shadrackb1/unihubke/blob/main/src/App.tsx"
click node_search "https://github.com/shadrackb1/unihubke/blob/main/src/components/HeroSearch.tsx"
click node_listing "https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/ListingsPage.tsx"
click node_property "https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/PropertyDetailsPage.tsx"
click node_hostels "https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/HostelsPage.tsx"
click node_hostel "https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/HostelDetailsPage.tsx"
click node_maps "https://github.com/shadrackb1/unihubke/blob/main/src/components/Map.tsx"
click node_landlord "https://github.com/shadrackb1/unihubke/blob/main/src/pages/LandlordDashboard.tsx"
click node_admin "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminDashboard.tsx"
click node_propertyadmin "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminPropertyForm.tsx"
click node_hosteladmin "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminHostelForm.tsx"
click node_roomadmin "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminHostelRoomForm.tsx"
click node_cms "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminCMSPage.tsx"
click node_agents "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminAgentsPage.tsx"
click node_universities "https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminUniversityForm.tsx"
click node_mediaadmin "https://github.com/shadrackb1/unihubke/blob/main/src/pages/AdminMediaManager.tsx"
click node_master "https://github.com/shadrackb1/unihubke/blob/main/src/pages/MasterDashboard.tsx"
click node_auth "https://github.com/shadrackb1/unihubke/blob/main/src/context/AuthContext.tsx"
click node_firestore "https://github.com/shadrackb1/unihubke/blob/main/src/services/firestore.ts"
click node_firebase "https://github.com/shadrackb1/unihubke/blob/main/src/lib/firebase.ts"
click node_upload "https://github.com/shadrackb1/unihubke/blob/main/src/lib/storage.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_app,node_search,node_listing,node_property,node_hostels,node_hostel,node_maps toneBlue
class node_landlord,node_admin,node_propertyadmin,node_hosteladmin,node_roomadmin,node_cloudinary toneAmber
class node_cms,node_agents,node_universities,node_mediaadmin,node_master toneMint
class node_auth,node_firestore,node_firebase,node_upload toneRose
class node_visitor toneIndigo
```

## Components

### Housing discovery

- [Application routes](https://github.com/shadrackb1/unihubke/blob/main/src/App.tsx): `src/App.tsx`
- [University search](https://github.com/shadrackb1/unihubke/blob/main/src/components/HeroSearch.tsx): `src/components/HeroSearch.tsx`
- [Listing browse](https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/ListingsPage.tsx): `src/pages/public/ListingsPage.tsx`
- [Property details](https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/PropertyDetailsPage.tsx): `src/pages/public/PropertyDetailsPage.tsx`
- [Hostel browse](https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/HostelsPage.tsx): `src/pages/public/HostelsPage.tsx`
- [Hostel details](https://github.com/shadrackb1/unihubke/blob/main/src/pages/public/HostelDetailsPage.tsx): `src/pages/public/HostelDetailsPage.tsx`
- [Listing maps](https://github.com/shadrackb1/unihubke/blob/main/src/components/Map.tsx): `src/components/Map.tsx`

### Housing management

- [Landlord dashboard](https://github.com/shadrackb1/unihubke/blob/main/src/pages/LandlordDashboard.tsx): `src/pages/LandlordDashboard.tsx`
- [Admin workspace](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminDashboard.tsx): `src/pages/admin/AdminDashboard.tsx`
- [Property management](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminPropertyForm.tsx): `src/pages/admin/AdminPropertyForm.tsx`
- [Hostel management](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminHostelForm.tsx): `src/pages/admin/AdminHostelForm.tsx`
- [Room management](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminHostelRoomForm.tsx): `src/pages/admin/AdminHostelRoomForm.tsx`

### Platform operations

- [Site CMS](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminCMSPage.tsx): `src/pages/admin/AdminCMSPage.tsx`
- [Agent management](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminAgentsPage.tsx): `src/pages/admin/AdminAgentsPage.tsx`
- [University management](https://github.com/shadrackb1/unihubke/blob/main/src/pages/admin/AdminUniversityForm.tsx): `src/pages/admin/AdminUniversityForm.tsx`
- [Media manager](https://github.com/shadrackb1/unihubke/blob/main/src/pages/AdminMediaManager.tsx): `src/pages/AdminMediaManager.tsx`
- [Master dashboard](https://github.com/shadrackb1/unihubke/blob/main/src/pages/MasterDashboard.tsx): `src/pages/MasterDashboard.tsx`

### Shared services

- [User authentication](https://github.com/shadrackb1/unihubke/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Firestore services](https://github.com/shadrackb1/unihubke/blob/main/src/services/firestore.ts): `src/services/firestore.ts`
- [Firebase setup](https://github.com/shadrackb1/unihubke/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Media upload](https://github.com/shadrackb1/unihubke/blob/main/src/lib/storage.ts): `src/lib/storage.ts`

### Other components

- **Housing seeker**
- **Cloudinary**

## Connections

- Housing seeker → Application routes: opens (evidence: `src/App.tsx`)
- Application routes → Listing browse: routes to (evidence: `src/App.tsx`)
- Application routes → Property details: routes to (evidence: `src/App.tsx`)
- Application routes → Hostel browse: routes to (evidence: `src/App.tsx`)
- Application routes → Hostel details: routes to (evidence: `src/App.tsx`)
- Application routes → Admin workspace: routes to (evidence: `src/App.tsx`)
- University search → Firebase setup: reads universities (evidence: `src/components/HeroSearch.tsx`)
- Listing browse → Firestore services: loads listings (evidence: `src/pages/public/ListingsPage.tsx`)
- Property details → Firestore services: loads details (evidence: `src/pages/public/PropertyDetailsPage.tsx`)
- Hostel details → Firestore services: loads hostel (evidence: `src/pages/public/HostelDetailsPage.tsx`)
- Listing browse → Listing maps: displays locations
- Landlord dashboard → Firestore services: manages listings (evidence: `src/pages/LandlordDashboard.tsx`)
- Admin workspace → Property management: routes to
- Admin workspace → Hostel management: routes to
- Admin workspace → Room management: routes to
- Property management → Firestore services: writes properties (evidence: `src/pages/admin/AdminPropertyForm.tsx`)
- Hostel management → Firestore services: writes hostels (evidence: `src/pages/admin/AdminHostelForm.tsx`)
- Room management → Firestore services: writes rooms (evidence: `src/pages/admin/AdminHostelRoomForm.tsx`)
- Site CMS → Firestore services: saves settings (evidence: `src/pages/admin/AdminCMSPage.tsx`)
- Agent management → Firestore services: manages agents (evidence: `src/pages/admin/AdminAgentsPage.tsx`)
- University management → Firestore services: manages universities (evidence: `src/pages/admin/AdminUniversityForm.tsx`)
- Media manager → Media upload: uploads media (evidence: `src/pages/AdminMediaManager.tsx`)
- Landlord dashboard → Media upload: uploads media (evidence: `src/pages/LandlordDashboard.tsx`)
- Site CMS → Media upload: uploads media
- Media upload → Cloudinary: sends uploads (evidence: `src/lib/storage.ts`)
- Firestore services → Firebase setup: uses database (evidence: `src/services/firestore.ts`)
- User authentication → Firebase setup: uses authentication (evidence: `src/context/AuthContext.tsx`)
- Master dashboard → Firestore services: manages platform
