How skygod07/amityconnect works
AmityConnect is a campus community app for safety, mobility, errands, and student connections. The primary workflow is a student entering the dashboard, then using a feature area to post or find a ride or errand, or raise an SOS; faculty can respond to emergencies. The graph also preserves profiles, messaging, study groups, notifications, and gamification. README statements support the product capabilities; source-index references and excerpts support only the noted implementation links. The tree also contains an Android client, but its feature wiring was not inspected.
Main entry points: rides/page.tsx Ride board · app/page.tsx Campus dashboard · [userId]/page.tsx Member profiles · study/page.tsx Study groups
Components 25
Web experience
- Campus dashboard
src/app/page.tsx - Ride board
src/app/(dashboard)/rides/page.tsx - Route matching
src/lib/matching.ts - Ride notifications
src/app/api/rides/notify/route.ts - Errands marketplace
src/app/(dashboard)/errands/page.tsx
Emergency response
- SOS controls
src/app/(dashboard)/sos/page.tsx - Responder overlay
src/components/sos/EmergencyAlertOverlay.tsx - Location map
src/components/map/MapView.tsx
Campus community
- People search
src/components/search/SearchPeople.tsx - Member profiles
src/app/(dashboard)/profile/[userId]/page.tsx - Direct messaging
src/components/chat/FloatingChat.tsx - Study groups
src/app/(dashboard)/study/page.tsx - Faculty directory
src/app/(dashboard)/faculty/page.tsx - Badges and stats
src/components/profile/ProfileBadges.tsx - Activity tracking
src/lib/activityTracker.ts
Identity and services
- Authentication state
src/context/AuthContext.tsx - Firebase client
src/lib/firebase.ts - Cloud Firestore
- Firebase Auth
- Notification service
src/lib/notifications.ts
Android client
- Android navigation
android/app/src/main/java/com/amityconnect/navigation/NavHost.kt - Android home
android/app/src/main/java/com/amityconnect/ui/home/HomeScreen.kt - Android feature screens
android/app/src/main/java/com/amityconnect/ui
Other components
- Student
- Faculty responder
Connections 29
- Student → Campus dashboard: opens
README.md - Campus dashboard → Ride board: links to
src/app/page.tsx - Campus dashboard → SOS controls: links to
src/app/page.tsx - Student → Ride board: posts or finds
README.md - Ride board → Route matching: matches routes
README.md - Ride board → Cloud Firestore: reads and writes
src/app/(dashboard)/rides/page.tsx - Ride board → Ride notifications: notifies
- Student → Errands marketplace: requests help
README.md - Student → SOS controls: raises alert
README.md - SOS controls → Location map: shows location
src/app/(dashboard)/sos/page.tsx - Faculty responder → Responder overlay: responds to alert
README.md - Responder overlay → Cloud Firestore: reads and writes
- Student → People search: searches members
- People search → Cloud Firestore: reads profiles
src/components/search/SearchPeople.tsx - Student → Member profiles: views profile
- Member profiles → Cloud Firestore: reads and writes
src/app/(dashboard)/profile/[userId]/page.tsx - Member profiles → Direct messaging: starts message
src/app/(dashboard)/profile/[userId]/page.tsx - Student → Study groups: joins or creates
README.md - Study groups → Cloud Firestore: streams and updates
src/app/(dashboard)/study/page.tsx - Student → Faculty directory: browses faculty
- Student → Badges and stats: views impact
README.md - Activity tracking → Cloud Firestore: tracks activity
- Badges and stats → Activity tracking: reflects activity
- Authentication state → Firebase client: uses auth client
src/context/AuthContext.tsx - Firebase client → Firebase Auth: initializes
src/lib/firebase.ts - Firebase client → Cloud Firestore: initializes
src/lib/firebase.ts - Study groups → Notification service: sends updates
src/app/(dashboard)/study/page.tsx - Android navigation → Android home: routes to
- Android navigation → Android feature screens: routes to