How laralbir/japan-travel-tools works
Japan Travel Tools is an offline-first Android travel companion. The principal user workflow is to open the app, choose a travel tool, use locally available or cached travel data, and save or export results. Its major branches cover itinerary planning, travel utilities, documents and emergency help, and optional online services such as weather, currency updates, cloud backup, and app updates. Source excerpts show app startup and some UI-to-feature references; many feature implementations were not sampled, so uncertain connections are omitted rather than inferred.
Main entry points: MainScreen.kt Main Screen · TripPlannerUseCase.kt Trip Planner · MainActivity.kt Android Activity · DocumentsAndGuidesUseCase.kt Documents & Guides
Components 22
App Experience
- Android Activity
app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt - App Navigation
app/src/main/kotlin/com/laralbir/japantraveltools/Navigation.kt - Main Screen
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - User Preferences
app/src/main/kotlin/com/laralbir/japantraveltools/core/preferences/UserPreferencesRepository.kt
Trip Planning
- Trip Planner
app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt - Itinerary Map
app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/map/DayItineraryMapView.kt - Route Optimizer
app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/optimizer/DayRouteOptimizer.kt - PDF Export
app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/pdf/data/AndroidItineraryPdfExporter.kt
Travel Utilities
- Transport Planner
app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/TransportPlannerUseCase.kt - Pass Import
app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt - World Clock
- Currency Converter
app/src/main/kotlin/com/laralbir/japantraveltools/feature/currency/CurrencyConverterUseCase.kt - Weather
app/src/main/kotlin/com/laralbir/japantraveltools/feature/weather/OpenMeteoWeatherUseCase.kt - Offline Translator
app/src/main/kotlin/com/laralbir/japantraveltools/feature/ai/OfflineTranslatorEngine.kt
Documents & Safety
- Documents & Guides
app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt - Emergency Help
app/src/main/kotlin/com/laralbir/japantraveltools/feature/emergency/ui/EmergencyScreen.kt - Shopping Receipts
app/src/main/kotlin/com/laralbir/japantraveltools/feature/taxfree/TaxFreeReportGenerator.kt
Sync & Services
- JSON Portability
app/src/main/kotlin/com/laralbir/japantraveltools/core/portability/TravelPlanJsonPortability.kt - Drive Backup
app/src/main/kotlin/com/laralbir/japantraveltools/core/cloud/GoogleDriveSyncHelper.kt - App Updater
app/src/main/kotlin/com/laralbir/japantraveltools/feature/updater/ui/AppUpdateViewModel.kt - Connectivity Status
app/src/main/kotlin/com/laralbir/japantraveltools/core/network/ConnectivityStatusHelper.kt
Other components
- Traveler
Connections 19
- Android Activity → App Navigation: starts
app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt - Traveler → Main Screen: uses
- Main Screen → Offline Translator: uses
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → JSON Portability: uses
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Drive Backup: shows
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → App Updater: creates
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Connectivity Status: references
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Trip Planner → Itinerary Map: renders
- Trip Planner → Route Optimizer: optimizes
- Trip Planner → PDF Export: exports
- Pass Import → Documents & Guides: creates ticket
app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt - Android Activity → Connectivity Status: checks
- Main Screen → Trip Planner: offers
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Transport Planner: offers
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Weather: offers
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Currency Converter: offers
- Main Screen → Documents & Guides: offers
- Main Screen → Emergency Help: offers
app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt - Main Screen → Shopping Receipts: offers