How shadrackb1/unihubke works
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: firestore.ts Firestore services · App.tsx Application routes · AdminDashboard.tsx Admin workspace · storage.ts Media upload
Components 23
Housing discovery
- Application routes
src/App.tsx - University search
src/components/HeroSearch.tsx - Listing browse
src/pages/public/ListingsPage.tsx - Property details
src/pages/public/PropertyDetailsPage.tsx - Hostel browse
src/pages/public/HostelsPage.tsx - Hostel details
src/pages/public/HostelDetailsPage.tsx - Listing maps
src/components/Map.tsx
Housing management
- Landlord dashboard
src/pages/LandlordDashboard.tsx - Admin workspace
src/pages/admin/AdminDashboard.tsx - Property management
src/pages/admin/AdminPropertyForm.tsx - Hostel management
src/pages/admin/AdminHostelForm.tsx - Room management
src/pages/admin/AdminHostelRoomForm.tsx
Platform operations
- Site CMS
src/pages/admin/AdminCMSPage.tsx - Agent management
src/pages/admin/AdminAgentsPage.tsx - University management
src/pages/admin/AdminUniversityForm.tsx - Media manager
src/pages/AdminMediaManager.tsx - Master dashboard
src/pages/MasterDashboard.tsx
Shared services
- User authentication
src/context/AuthContext.tsx - Firestore services
src/services/firestore.ts - Firebase setup
src/lib/firebase.ts - Media upload
src/lib/storage.ts
Other components
- Housing seeker
- Cloudinary
Connections 28
- Housing seeker → Application routes: opens
src/App.tsx - Application routes → Listing browse: routes to
src/App.tsx - Application routes → Property details: routes to
src/App.tsx - Application routes → Hostel browse: routes to
src/App.tsx - Application routes → Hostel details: routes to
src/App.tsx - Application routes → Admin workspace: routes to
src/App.tsx - University search → Firebase setup: reads universities
src/components/HeroSearch.tsx - Listing browse → Firestore services: loads listings
src/pages/public/ListingsPage.tsx - Property details → Firestore services: loads details
src/pages/public/PropertyDetailsPage.tsx - Hostel details → Firestore services: loads hostel
src/pages/public/HostelDetailsPage.tsx - Listing browse → Listing maps: displays locations
- Landlord dashboard → Firestore services: manages listings
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
src/pages/admin/AdminPropertyForm.tsx - Hostel management → Firestore services: writes hostels
src/pages/admin/AdminHostelForm.tsx - Room management → Firestore services: writes rooms
src/pages/admin/AdminHostelRoomForm.tsx - Site CMS → Firestore services: saves settings
src/pages/admin/AdminCMSPage.tsx - Agent management → Firestore services: manages agents
src/pages/admin/AdminAgentsPage.tsx - University management → Firestore services: manages universities
src/pages/admin/AdminUniversityForm.tsx - Media manager → Media upload: uploads media
src/pages/AdminMediaManager.tsx - Landlord dashboard → Media upload: uploads media
src/pages/LandlordDashboard.tsx - Site CMS → Media upload: uploads media
- Media upload → Cloudinary: sends uploads
src/lib/storage.ts - Firestore services → Firebase setup: uses database
src/services/firestore.ts - User authentication → Firebase setup: uses authentication
src/context/AuthContext.tsx - Master dashboard → Firestore services: manages platform