How nishantrajora/roomsync works
ROOMSYNC is a student roommate-finding and co-living app. Students sign up or log in, build profiles, discover listings and compatible roommates, then use tools for safer visits and shared living. The main internal layer is AppContext, which coordinates application state and Firebase access. The README documents major safety, agreement, and co-living capabilities; some implementation details are not sampled, so those connections are shown only where documented or indexed.
Main entry points: App.tsx App router · AppContext.tsx Shared app state · MatchesPage.tsx Compatibility matches · DiscoverPage.tsx Room discovery
Components 26
App entry
- App router
src/App.tsx - Landing
src/pages/LandingPage.tsx - Authentication
src/pages/AuthPage.tsx - Onboarding
src/components/onboarding/OnboardingModal.tsx
Discovery and trust
- Room discovery
src/pages/DiscoverPage.tsx - Compatibility matches
src/pages/MatchesPage.tsx - Compatibility radar
src/components/matching/RadarChartModal.tsx - Listing trust scoring
src/lib/trust.ts - Compatibility scoring
src/lib/scoring.ts
Safety tools
- Safety map
src/pages/SafetyMapPage.tsx - Visit check-in
src/components/common/SosCheckinModal.tsx - Agreement analyzer
src/pages/AgreementAnalyzerPage.tsx - Clause analysis
src/lib/nlp.ts
Co-living management
- Roommate pact
src/pages/RoommatePactPage.tsx - Bill splitting
src/pages/BillSplitterPage.tsx - Expense settlement
src/lib/settlement.ts - Landlord reviews
src/pages/ReviewsPage.tsx - Messaging
src/pages/MessagesPage.tsx
Shared application layer
- Profile management
src/pages/ProfilePage.tsx - App shell
src/components/layout/AppShell.tsx - Shared app state
src/context/AppContext.tsx - Firebase access
src/lib/firebase.ts - Seed data
src/data/seedData.ts
Other components
- Student
- Leaflet maps
- Firestore
Connections 36
- Student → App router: opens app
src/App.tsx - App router → Shared app state: provides state
src/App.tsx - App router → Landing: routes public
src/App.tsx - App router → Authentication: routes login
src/App.tsx - App router → App shell: renders dashboard
src/App.tsx - App router → Room discovery: routes tab
src/App.tsx - App router → Compatibility matches: routes tab
src/App.tsx - App router → Safety map: routes tab
src/App.tsx - App router → Agreement analyzer: routes tab
src/App.tsx - App router → Roommate pact: routes tab
src/App.tsx - App router → Bill splitting: routes tab
src/App.tsx - App router → Landlord reviews: routes tab
src/App.tsx - App router → Messaging: routes tab
src/App.tsx - App router → Profile management: routes tab
src/App.tsx - Authentication → Shared app state: uses state
src/pages/AuthPage.tsx - Onboarding → Shared app state: uses state
src/components/onboarding/OnboardingModal.tsx - Room discovery → Shared app state: uses state
src/pages/DiscoverPage.tsx - Room discovery → Listing trust scoring: scores listings
src/pages/DiscoverPage.tsx - Compatibility matches → Shared app state: uses state
src/pages/MatchesPage.tsx - Compatibility matches → Compatibility radar: opens comparison
src/pages/MatchesPage.tsx - Compatibility matches → Compatibility scoring: calculates compatibility
src/pages/MatchesPage.tsx - Safety map → Shared app state: uses state
src/pages/SafetyMapPage.tsx - Visit check-in → Shared app state: uses state
src/components/common/SosCheckinModal.tsx - Agreement analyzer → Shared app state: uses state
src/pages/AgreementAnalyzerPage.tsx - Agreement analyzer → Clause analysis: analyzes clauses
src/pages/AgreementAnalyzerPage.tsx - Roommate pact → Shared app state: uses state
src/pages/RoommatePactPage.tsx - Bill splitting → Shared app state: uses state
src/pages/BillSplitterPage.tsx - Bill splitting → Expense settlement: calculates settlement
src/pages/BillSplitterPage.tsx - Landlord reviews → Shared app state: uses state
src/pages/ReviewsPage.tsx - Messaging → Shared app state: uses state
src/pages/MessagesPage.tsx - Profile management → Shared app state: uses state
src/pages/ProfilePage.tsx - App shell → Shared app state: reads app state
src/components/layout/AppShell.tsx - Shared app state → Firebase access: uses Firebase
src/context/AppContext.tsx - Firebase access → Firestore: reads and writes
src/lib/firebase.ts - Shared app state → Seed data: loads initial data
src/context/AppContext.tsx - Safety map → Leaflet maps: visualizes locality safety
README.md