How swent-roamigo/roamigo works
Roamigo is an Android group-travel planning app. Users sign in, create a trip with destinations and dates, invite friends, collaboratively maintain an itinerary, and vote on activities; during travel they share live locations and geotagged photos on maps, with cached plans and queued changes for offline use. The graph separates UI, trip collaboration, integrations, and supporting capabilities. README statements establish the broad feature relationships; source-index references and excerpts support only selected internal calls, so uncertain wiring is omitted or dashed.
Main entry points: CreateTripViewModel.kt Trip creation · TripMapViewModel.kt Location map · PhotosViewModel.kt Trip photos · TripScreen.kt Trip screens
Components 29
Android app
- App entry
app/src/main/java/com/swent/roamigo/MainActivity.kt - App shell
app/src/main/java/com/swent/roamigo/ui/RoamigoApp.kt - Sign-in UI
app/src/main/java/com/swent/roamigo/ui/authentication/AuthenticationScreen.kt - Auth state
app/src/main/java/com/swent/roamigo/ui/authentication/AuthenticationViewModel.kt - Trip screens
app/src/main/java/com/swent/roamigo/ui/trip/TripScreen.kt - Voting screens
app/src/main/java/com/swent/roamigo/ui/trip/voting/VoteViewModel.kt - Location map
app/src/main/java/com/swent/roamigo/ui/map/TripMapViewModel.kt - Trip photos
app/src/main/java/com/swent/roamigo/ui/photos/PhotosViewModel.kt - Trip history
app/src/main/java/com/swent/roamigo/ui/trip/history/TripHistoryViewModel.kt - Explored countries
app/src/main/java/com/swent/roamigo/ui/heatmap/TravelHeatmapViewModel.kt
Trip planning
- Trip creation
app/src/main/java/com/swent/roamigo/ui/trip/creation/CreateTripViewModel.kt - Destination search
app/src/main/java/com/swent/roamigo/model/destination/OnlineDestinationRepository.kt - Place search
app/src/main/java/com/swent/roamigo/model/place/MapboxPlaceRepository.kt - Trip records
app/src/main/java/com/swent/roamigo/model/trip/TripRepositoryFirestore.kt - Itinerary activities
app/src/main/java/com/swent/roamigo/model/trip/activity/ActivityRepositoryFirestore.kt
Group collaboration
- Friend network
app/src/main/java/com/swent/roamigo/model/friends/FriendRepositoryFirestore.kt - Vote data
app/src/main/java/com/swent/roamigo/model/trip/voting/VoteRepositoryFirestore.kt
Travel experience
- Location sharing
app/src/main/java/com/swent/roamigo/model/location/DefaultLocationRepository.kt - Photo sync
app/src/main/java/com/swent/roamigo/model/photo/DefaultPhotoRepository.kt - Interactive map
- Country tracking
app/src/main/java/com/swent/roamigo/model/country/VisitedCountryRepository.kt
Backend services
- Firebase auth
app/src/main/java/com/swent/roamigo/model/authentication/AuthRepositoryFirebase.kt - Trip invitations
functions/src/tripInvitations.ts - Vote resolution
app/src/main/java/com/swent/roamigo/model/trip/voting/VoteResolutionService.kt - Vote functions
functions/src/voteResolution.ts
Other components
- Traveler
- Firebase Authentication
- Realtime Database
- Firebase Storage
Connections 28
- Traveler → App entry: opens
- App entry → App shell: launches
app/src/main/java/com/swent/roamigo/MainActivity.kt - App shell → Sign-in UI: presents
- Sign-in UI → Auth state: submits credentials
- Auth state → Firebase auth: authenticates
- Firebase auth → Firebase Authentication: signs in
app/src/main/java/com/swent/roamigo/model/authentication/AuthRepositoryFirebase.kt - Traveler → Trip creation: plans trip
- Trip creation → Destination search: searches destinations
- Trip creation → Trip records: creates trip
- Trip creation → Place search: suggests places
- Trip screens → Trip records: reads itinerary
- Trip screens → Itinerary activities: edits activities
- Traveler → Friend network: manages friends
- Traveler → Trip invitations: invites members
README.md - Traveler → Voting screens: casts votes
- Voting screens → Vote data: submits ballots
- Vote resolution → Vote functions: calls functions
app/src/main/java/com/swent/roamigo/model/trip/voting/VoteResolutionService.kt - Traveler → Location map: views group map
README.md - Location map → Location sharing: shares positions
- Location sharing → Realtime Database: publishes locations
app/src/main/java/com/swent/roamigo/model/location/DefaultLocationRepository.kt - Traveler → Trip photos: shares photos
README.md - Trip photos → Photo sync: queues photos
- Photo sync → Firebase Storage: uploads photos
README.md - Location map → Interactive map: renders locations
README.md - Trip photos → Interactive map: shows geotagged photos
README.md - Traveler → Trip history: reviews trips
- Trip history → Explored countries: opens exploration map
- Explored countries → Country tracking: tracks countries