How samkwibe/family-housing-hub works
Family Housing Hub combines React web and Expo mobile clients with a Python API and Firebase functions. The web workflow authenticates a household member, routes them to a role-appropriate dashboard, and exposes housing and family-management features backed by client data services. Backend household routes and services provide household-scoped operations, with additional automation and background-task capabilities. The README establishes the separate runtimes; source-index references and excerpts support only selected internal links, so unsampled integrations are not connected speculatively.
Main entry points: DashboardRouter.jsx Role dashboard routing · AuthContext.jsx Web authentication · App.jsx Web application · firebaseService.js Firebase data service
Components 24
Web experience
- Web application
src/App.jsx - Route mapping
src/router/index.jsx - Role dashboard routing
src/components/DashboardRouter.jsx - Navigation layout
src/components/Layout.jsx - Theme context
src/contexts/ThemeContext.jsx
Identity and household
- Web authentication
src/contexts/AuthContext.jsx - Firebase configuration
src/firebase/config.js - Firebase data service
src/services/firebaseService.js - User data service
src/services/userDataService.js - Family context
src/contexts/FamilyContext.jsx
Family and housing
- Renter dashboard
src/pages/Dashboard.jsx - Owner dashboard
src/pages/OwnerDashboard.jsx - Child dashboard
src/pages/ChildDashboard.jsx - Rent and housing search
src/pages/Rent.jsx - Family messaging
src/pages/Messages.jsx - Profile management
src/pages/Profile.jsx
Python services
- Household API routes
backend/household_routes.py - Household membership
backend/household_service.py - Database access
backend/database.py - Household automations
backend/automation_engine.py - Background tasks
backend/tasks.py
Mobile and cloud
- Expo mobile client
mobile/app/index.tsx - Firebase functions
functions/index.js
Other components
- Household member
Connections 25
- Household member → Web application: uses
README.md - Web application → Route mapping: routes through
src/App.jsx - Route mapping → Renter dashboard: routes to
src/router/index.jsx - Web application → Role dashboard routing: renders dashboard routing
src/App.jsx - Role dashboard routing → Web authentication: reads user state
src/components/DashboardRouter.jsx - Role dashboard routing → User data service: loads user data
src/components/DashboardRouter.jsx - Role dashboard routing → Owner dashboard: renders owner view
src/components/DashboardRouter.jsx - Role dashboard routing → Child dashboard: renders child view
src/components/DashboardRouter.jsx - Web application → Navigation layout: wraps protected pages
src/App.jsx - Web authentication → Firebase configuration: uses Firebase auth
src/contexts/AuthContext.jsx - Web authentication → Firebase data service: uses data service
src/contexts/AuthContext.jsx - Firebase data service → Firebase configuration: uses Firebase setup
src/services/firebaseService.js - Renter dashboard → Family context: reads household context
src/pages/Dashboard.jsx - Renter dashboard → User data service: loads user data
src/pages/Dashboard.jsx - Owner dashboard → User data service: loads owner data
src/pages/OwnerDashboard.jsx - Child dashboard → Firebase data service: reads family records
src/pages/ChildDashboard.jsx - Rent and housing search → Web authentication: reads signed-in user
- Family messaging → Firebase data service: uses family data service
src/pages/Messages.jsx - Family messaging → Firebase configuration: uses Firebase setup
src/pages/Messages.jsx - Profile management → Web authentication: uses account context
- Household API routes → Household membership: delegates household operations
backend/household_routes.py - Household membership → Database access: accesses database
backend/household_service.py - Household membership → Background tasks: queues work
backend/household_service.py - Household API routes → Household automations: invokes automation
backend/household_routes.py - Expo mobile client → Household API routes: uses Python API