How flstupid/locationtracker works
LocationTracker is an Android app for trusted-contact location sharing. Its documented main flow is user actions through feature UI and ViewModels into use cases and repositories, which cache locally before remote synchronization; UI observes resulting streams. The graph includes map, history, social, activity, tracking, and notification capabilities named in the README. Source excerpts did not include runtime Kotlin, so relationships beyond README-described data flow and capabilities are omitted.
Main entry points: feature Feature screens · repository Repository implementations · LocalDataSourceImpl.kt Local data source · usecase Use cases
Components 18
App experience
- Feature screens
app/src/main/kotlin/com/example/locationtracker/feature - Feature ViewModels
app/src/main/kotlin/com/example/locationtracker/feature - Live map
app/src/main/kotlin/com/example/locationtracker/feature/live_location/LiveLocationMapScreen.kt - Location history
app/src/main/kotlin/com/example/locationtracker/feature/location_history - Friends and family
app/src/main/kotlin/com/example/locationtracker/feature - Activity feed
app/src/main/kotlin/com/example/locationtracker/feature/feed
Domain logic
- Use cases
app/src/main/kotlin/com/example/locationtracker/domain/usecase - Repository interfaces
app/src/main/kotlin/com/example/locationtracker/domain/repository
Persistence and sync
- Repository implementations
app/src/main/kotlin/com/example/locationtracker/data/repository - Local data source
app/src/main/kotlin/com/example/locationtracker/data/local/LocalDataSourceImpl.kt - Room database
app/src/main/kotlin/com/example/locationtracker/data/room/AppDatabase.kt - Remote data source
app/src/main/kotlin/com/example/locationtracker/data/remote/RemoteDataSourceImpl.kt
Tracking and messaging
- Foreground tracking
app/src/main/kotlin/com/example/locationtracker/core/service/LocationUpdateService.kt - Location client
app/src/main/kotlin/com/example/locationtracker/data/location/DefaultLocationClient.kt - Push notifications
app/src/main/kotlin/com/example/locationtracker/core/notification/NotificationService.kt
Other components
- App user
- Firebase backend
- Firebase messaging
Connections 16
- App user → Feature screens: acts in
README.md - Feature screens → Feature ViewModels: emits actions
README.md - Feature ViewModels → Use cases: orchestrates
README.md - Use cases → Repository interfaces: uses
- Repository interfaces → Repository implementations: implemented by
- Repository implementations → Local data source: caches locally
README.md - Local data source → Room database: persists in
- Repository implementations → Remote data source: syncs remotely
README.md - Remote data source → Firebase backend: syncs with
- Feature screens → Local data source: observes streams
README.md - Foreground tracking → Location client: gets location
- Push notifications → Firebase messaging: uses messaging
- Live map → App user: shows locations
- Location history → App user: shows timeline
- Friends and family → App user: manages contacts
- Activity feed → App user: shows activity