# xeiniya/minsktransportcrossplatform architecture

> Architecture diagram of the GitHub repository xeiniya/minsktransportcrossplatform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xeiniya/minsktransportcrossplatform
- Repository: https://github.com/xeiniya/minsktransportcrossplatform

## Overview

MinskTransportCrossplatform is a Flutter transport guide for Minsk, targeting Android, iOS, Linux, and Web (with platform scaffolding also present for macOS and Windows). Its central user journey is browsing routes and stops, then opening route details; favorites, authentication, settings, localization, offline caching, notifications, and adaptive presentation are additional capabilities documented in the README. Dart implementation files were not sampled, so links among those subsystems are not asserted. Native runner nodes cover the indexed platform-hosting modules, not build or delivery machinery.

Main entry points: [`lib/features/routes/screens/routes_screen.dart`](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/routes_screen.dart) (Route browsing), [`lib/features/routes/screens/route_detail_screen.dart`](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/route_detail_screen.dart) (Route details), [`lib/data/repositories/route_repository.dart`](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/repositories/route_repository.dart) (Route repository), [`lib/main.dart`](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/main.dart) (Flutter entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["App experience"]
  node_entry["Flutter entry<br/>[main.dart]"]
  node_navigation["App navigation<br/>[routes.dart]"]
  node_app_shell["App shell<br/>[app.dart]"]
  node_adaptive_ui["Adaptive UI"]
  node_theme["Theme settings<br/>[app_theme.dart]"]
  node_localization["Localization"]
end

subgraph group_transport["Transport features"]
  node_auth["Authentication<br/>[auth_provider.dart]"]
  node_login["Login screen<br/>[login_screen.dart]"]
  node_route_browse["Route browsing<br/>[routes_screen.dart]"]
  node_route_state["Route state"]
  node_map["Route map<br/>[map_screen.dart]"]
  node_route_detail["Route details"]
  node_route_card["Route card<br/>[route_card.dart]"]
  node_stop_card["Stop card<br/>[stop_card.dart]"]
  node_favorites["Favorites"]
  node_favorites_screen["Favorites screen"]
  node_settings["App settings"]
  node_settings_screen["Settings screen"]
end

subgraph group_data["Data and services"]
  node_repository["Route repository"]
  node_database[("Local database")]
  node_route_model["Route model"]
  node_stop_model["Stop model<br/>[route_stop.dart]"]
  node_connectivity["Connectivity service"]
  node_notifications["Notifications"]
  node_weather["Weather service"]
end

subgraph group_platform["Platform hosting"]
  node_linux_runner["Linux host<br/>[my_application.cc]"]
  node_linux_api["Linux app API<br/>[my_application.h]"]
  node_windows_runner["Windows host<br/>[main.cpp]"]
  node_flutter_window["Flutter window<br/>[flutter_window.h]"]
  node_win32_window["Win32 window<br/>[win32_window.h]"]
  node_win32_impl["Window implementation<br/>[win32_window.cpp]"]
  node_mac_plugins["macOS plugins"]
end

node_user(("Transport user"))

node_user -.->|"opens app"| node_entry
node_entry -.->|"starts"| node_app_shell
node_app_shell -.->|"uses navigation"| node_navigation
node_user -.->|"browses routes"| node_route_browse
node_route_browse -.->|"opens details"| node_route_detail
node_user -.->|"views routes"| node_map
node_user -.->|"authenticates"| node_login
node_user -.->|"manages favorites"| node_favorites_screen
node_user -.->|"changes settings"| node_settings_screen
node_route_browse -.->|"presents routes"| node_route_card
node_route_detail -.->|"presents stops"| node_stop_card
node_route_state -.->|"loads routes"| node_repository
node_repository -.->|"caches data"| node_database
node_repository -.->|"uses model"| node_route_model
node_route_detail -.->|"uses model"| node_stop_model
node_user -.->|"chooses language"| node_localization
node_user -.->|"chooses theme"| node_theme
node_user -.->|"receives alerts"| node_notifications
node_linux_runner -->|"implements API"| node_linux_api
node_windows_runner -->|"creates window"| node_flutter_window
node_flutter_window -->|"extends"| node_win32_window
node_win32_window -->|"implemented by"| node_win32_impl

click node_entry "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/main.dart"
click node_navigation "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/app/routes.dart"
click node_app_shell "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/app/app.dart"
click node_adaptive_ui "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/core/widgets/adaptive_scaffold.dart"
click node_theme "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/core/themes/app_theme.dart"
click node_localization "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/localization/app_localizations.dart"
click node_auth "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/auth/providers/auth_provider.dart"
click node_login "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/auth/screens/login_screen.dart"
click node_route_browse "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/routes_screen.dart"
click node_route_state "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/providers/route_provider.dart"
click node_map "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/map_screen.dart"
click node_route_detail "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/route_detail_screen.dart"
click node_route_card "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/widgets/route_card.dart"
click node_stop_card "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/widgets/stop_card.dart"
click node_favorites "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/favorites/providers/favorites_provider.dart"
click node_favorites_screen "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/favorites/screens/favorites_screen.dart"
click node_settings "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/settings/providers/settings_provider.dart"
click node_settings_screen "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/settings/screens/settings_screen.dart"
click node_repository "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/repositories/route_repository.dart"
click node_database "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/local/database_helper.dart"
click node_route_model "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/models/transport_route.dart"
click node_stop_model "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/models/route_stop.dart"
click node_connectivity "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/connectivity_service.dart"
click node_notifications "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/notification_service.dart"
click node_weather "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/weather_service.dart"
click node_linux_runner "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/linux/runner/my_application.cc"
click node_linux_api "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/linux/runner/my_application.h"
click node_windows_runner "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/main.cpp"
click node_flutter_window "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/flutter_window.h"
click node_win32_window "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/win32_window.h"
click node_win32_impl "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/win32_window.cpp"
click node_mac_plugins "https://github.com/xeiniya/minsktransportcrossplatform/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"

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_entry,node_navigation,node_app_shell,node_adaptive_ui,node_theme,node_localization,node_user toneBlue
class node_auth,node_login,node_route_browse,node_route_state,node_map,node_route_detail,node_route_card,node_stop_card,node_favorites,node_favorites_screen,node_settings,node_settings_screen toneAmber
class node_repository,node_database,node_route_model,node_stop_model,node_connectivity,node_notifications,node_weather toneMint
class node_linux_runner,node_linux_api,node_windows_runner,node_flutter_window,node_win32_window,node_win32_impl,node_mac_plugins toneRose
```

## Components

### App experience

- [Flutter entry](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/main.dart): `lib/main.dart`
- [App navigation](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/app/routes.dart): `lib/app/routes.dart`
- [App shell](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/app/app.dart): `lib/app/app.dart`
- [Adaptive UI](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/core/widgets/adaptive_scaffold.dart): `lib/core/widgets/adaptive_scaffold.dart`
- [Theme settings](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/core/themes/app_theme.dart): `lib/core/themes/app_theme.dart`
- [Localization](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/localization/app_localizations.dart): `lib/localization/app_localizations.dart`

### Transport features

- [Authentication](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/auth/providers/auth_provider.dart): `lib/features/auth/providers/auth_provider.dart`
- [Login screen](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/auth/screens/login_screen.dart): `lib/features/auth/screens/login_screen.dart`
- [Route browsing](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/routes_screen.dart): `lib/features/routes/screens/routes_screen.dart`
- [Route state](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/providers/route_provider.dart): `lib/features/routes/providers/route_provider.dart`
- [Route map](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/map_screen.dart): `lib/features/routes/screens/map_screen.dart`
- [Route details](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/screens/route_detail_screen.dart): `lib/features/routes/screens/route_detail_screen.dart`
- [Route card](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/widgets/route_card.dart): `lib/features/routes/widgets/route_card.dart`
- [Stop card](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/routes/widgets/stop_card.dart): `lib/features/routes/widgets/stop_card.dart`
- [Favorites](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/favorites/providers/favorites_provider.dart): `lib/features/favorites/providers/favorites_provider.dart`
- [Favorites screen](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/favorites/screens/favorites_screen.dart): `lib/features/favorites/screens/favorites_screen.dart`
- [App settings](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/settings/providers/settings_provider.dart): `lib/features/settings/providers/settings_provider.dart`
- [Settings screen](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/features/settings/screens/settings_screen.dart): `lib/features/settings/screens/settings_screen.dart`

### Data and services

- [Route repository](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/repositories/route_repository.dart): `lib/data/repositories/route_repository.dart`
- [Local database](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/local/database_helper.dart): `lib/data/local/database_helper.dart`
- [Route model](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/models/transport_route.dart): `lib/data/models/transport_route.dart`
- [Stop model](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/data/models/route_stop.dart): `lib/data/models/route_stop.dart`
- [Connectivity service](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/connectivity_service.dart): `lib/services/connectivity_service.dart`
- [Notifications](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/notification_service.dart): `lib/services/notification_service.dart`
- [Weather service](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/lib/services/weather_service.dart): `lib/services/weather_service.dart`

### Platform hosting

- [Linux host](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Linux app API](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Windows host](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Win32 window](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Window implementation](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [macOS plugins](https://github.com/xeiniya/minsktransportcrossplatform/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **Transport user**

## Connections

- Transport user → Flutter entry: opens app (evidence: `README.md`)
- Flutter entry → App shell: starts
- App shell → App navigation: uses navigation
- Transport user → Route browsing: browses routes (evidence: `README.md`)
- Route browsing → Route details: opens details (evidence: `README.md`)
- Transport user → Route map: views routes (evidence: `README.md`)
- Transport user → Login screen: authenticates (evidence: `README.md`)
- Transport user → Favorites screen: manages favorites (evidence: `README.md`)
- Transport user → Settings screen: changes settings (evidence: `README.md`)
- Route browsing → Route card: presents routes
- Route details → Stop card: presents stops
- Route state → Route repository: loads routes
- Route repository → Local database: caches data (evidence: `README.md`)
- Route repository → Route model: uses model
- Route details → Stop model: uses model
- Transport user → Localization: chooses language (evidence: `README.md`)
- Transport user → Theme settings: chooses theme (evidence: `README.md`)
- Transport user → Notifications: receives alerts (evidence: `README.md`)
- Linux host → Linux app API: implements API (evidence: `linux/runner/my_application.cc`)
- Windows host → Flutter window: creates window (evidence: `windows/runner/main.cpp`)
- Flutter window → Win32 window: extends (evidence: `windows/runner/flutter_window.h`)
- Win32 window → Window implementation: implemented by (evidence: `windows/runner/win32_window.h`)
