# laralbir/japan-travel-tools architecture

> Architecture diagram of the GitHub repository laralbir/japan-travel-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/laralbir/japan-travel-tools
- Repository: https://github.com/laralbir/japan-travel-tools

## Overview

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: [`app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt) (Main Screen), [`app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt`](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt) (Trip Planner), [`app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt`](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt) (Android Activity), [`app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt`](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt) (Documents & Guides)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Experience"]
  node_activity["Android Activity<br/>[MainActivity.kt]"]
  node_navigation["App Navigation<br/>[Navigation.kt]"]
  node_main_ui["Main Screen<br/>[MainScreen.kt]"]
  node_preferences[("User Preferences")]
end

subgraph group_planning["Trip Planning"]
  node_trip_planner["Trip Planner"]
  node_itinerary_map["Itinerary Map"]
  node_route_optimizer["Route Optimizer"]
  node_pdf_export["PDF Export"]
end

subgraph group_travel["Travel Utilities"]
  node_transport["Transport Planner"]
  node_pkpass["Pass Import<br/>[PkPassParser.kt]"]
  node_clocks["World Clock"]
  node_currency["Currency Converter"]
  node_weather["Weather"]
  node_translator["Offline Translator"]
end

subgraph group_safety["Documents &amp; Safety"]
  node_documents[("Documents &amp; Guides")]
  node_emergency["Emergency Help<br/>[EmergencyScreen.kt]"]
  node_receipts["Shopping Receipts"]
end

subgraph group_services["Sync &amp; Services"]
  node_json_portability["JSON Portability"]
  node_drive_sync["Drive Backup"]
  node_app_updates["App Updater"]
  node_connectivity["Connectivity Status"]
end

node_traveler(("Traveler"))

node_activity -->|"starts"| node_navigation
node_traveler -.->|"uses"| node_main_ui
node_main_ui -->|"uses"| node_translator
node_main_ui -->|"uses"| node_json_portability
node_main_ui -->|"shows"| node_drive_sync
node_main_ui -->|"creates"| node_app_updates
node_main_ui -->|"references"| node_connectivity
node_trip_planner -.->|"renders"| node_itinerary_map
node_trip_planner -.->|"optimizes"| node_route_optimizer
node_trip_planner -.->|"exports"| node_pdf_export
node_pkpass -->|"creates ticket"| node_documents
node_activity -.->|"checks"| node_connectivity
node_main_ui -.->|"offers"| node_trip_planner
node_main_ui -.->|"offers"| node_transport
node_main_ui -.->|"offers"| node_weather
node_main_ui -.->|"offers"| node_currency
node_main_ui -.->|"offers"| node_documents
node_main_ui -.->|"offers"| node_emergency
node_main_ui -.->|"offers"| node_receipts

click node_activity "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt"
click node_navigation "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/Navigation.kt"
click node_main_ui "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt"
click node_preferences "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/preferences/UserPreferencesRepository.kt"
click node_trip_planner "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt"
click node_itinerary_map "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/map/DayItineraryMapView.kt"
click node_route_optimizer "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/optimizer/DayRouteOptimizer.kt"
click node_pdf_export "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/pdf/data/AndroidItineraryPdfExporter.kt"
click node_transport "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/TransportPlannerUseCase.kt"
click node_pkpass "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt"
click node_currency "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/currency/CurrencyConverterUseCase.kt"
click node_weather "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/weather/OpenMeteoWeatherUseCase.kt"
click node_translator "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/ai/OfflineTranslatorEngine.kt"
click node_documents "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt"
click node_emergency "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/emergency/ui/EmergencyScreen.kt"
click node_receipts "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/taxfree/TaxFreeReportGenerator.kt"
click node_json_portability "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/portability/TravelPlanJsonPortability.kt"
click node_drive_sync "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/cloud/GoogleDriveSyncHelper.kt"
click node_app_updates "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/updater/ui/AppUpdateViewModel.kt"
click node_connectivity "https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/network/ConnectivityStatusHelper.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_navigation,node_main_ui,node_preferences toneBlue
class node_trip_planner,node_itinerary_map,node_route_optimizer,node_pdf_export toneAmber
class node_transport,node_pkpass,node_clocks,node_currency,node_weather,node_translator toneMint
class node_documents,node_emergency,node_receipts toneRose
class node_json_portability,node_drive_sync,node_app_updates,node_connectivity,node_traveler toneIndigo
```

## Components

### App Experience

- [Android Activity](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt`
- [App Navigation](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/Navigation.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/Navigation.kt`
- [Main Screen](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`
- [User Preferences](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/preferences/UserPreferencesRepository.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/core/preferences/UserPreferencesRepository.kt`

### Trip Planning

- [Trip Planner](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/TripPlannerUseCase.kt`
- [Itinerary Map](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/map/DayItineraryMapView.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/map/DayItineraryMapView.kt`
- [Route Optimizer](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/optimizer/DayRouteOptimizer.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/optimizer/DayRouteOptimizer.kt`
- [PDF Export](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/pdf/data/AndroidItineraryPdfExporter.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/planner/pdf/data/AndroidItineraryPdfExporter.kt`

### Travel Utilities

- [Transport Planner](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/TransportPlannerUseCase.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/TransportPlannerUseCase.kt`
- [Pass Import](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt`
- **World Clock**
- [Currency Converter](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/currency/CurrencyConverterUseCase.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/currency/CurrencyConverterUseCase.kt`
- [Weather](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/weather/OpenMeteoWeatherUseCase.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/weather/OpenMeteoWeatherUseCase.kt`
- [Offline Translator](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/ai/OfflineTranslatorEngine.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/ai/OfflineTranslatorEngine.kt`

### Documents & Safety

- [Documents & Guides](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/documents/DocumentsAndGuidesUseCase.kt`
- [Emergency Help](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/emergency/ui/EmergencyScreen.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/emergency/ui/EmergencyScreen.kt`
- [Shopping Receipts](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/taxfree/TaxFreeReportGenerator.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/taxfree/TaxFreeReportGenerator.kt`

### Sync & Services

- [JSON Portability](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/portability/TravelPlanJsonPortability.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/core/portability/TravelPlanJsonPortability.kt`
- [Drive Backup](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/cloud/GoogleDriveSyncHelper.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/core/cloud/GoogleDriveSyncHelper.kt`
- [App Updater](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/feature/updater/ui/AppUpdateViewModel.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/feature/updater/ui/AppUpdateViewModel.kt`
- [Connectivity Status](https://github.com/laralbir/japan-travel-tools/blob/main/app/src/main/kotlin/com/laralbir/japantraveltools/core/network/ConnectivityStatusHelper.kt): `app/src/main/kotlin/com/laralbir/japantraveltools/core/network/ConnectivityStatusHelper.kt`

### Other components

- **Traveler**

## Connections

- Android Activity → App Navigation: starts (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/MainActivity.kt`)
- Traveler → Main Screen: uses
- Main Screen → Offline Translator: uses (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → JSON Portability: uses (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → Drive Backup: shows (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → App Updater: creates (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → Connectivity Status: references (evidence: `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 (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/feature/transport/pkpass/PkPassParser.kt`)
- Android Activity → Connectivity Status: checks
- Main Screen → Trip Planner: offers (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → Transport Planner: offers (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → Weather: offers (evidence: `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 (evidence: `app/src/main/kotlin/com/laralbir/japantraveltools/ui/main/MainScreen.kt`)
- Main Screen → Shopping Receipts: offers
