# trajetto-pi/trajetto-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/trajetto-pi/trajetto-frontend
- Repository: https://github.com/trajetto-pi/trajetto-frontend

## Overview

Trajetto is a Flutter mobile app; the README describes only a starter project, so its domain behavior is inferred cautiously from screen and module names. The apparent user journey spans account/role setup, freight browsing and confirmation, and supporting map/search and chat screens. The tree also shows location, geocoding, routing, and route/place models. Source excerpts for the app were not provided, so relationships between these components cannot be verified and are omitted.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_app["Flutter app<br/>[main.dart]"]
  node_bottom_nav["Bottom navigation"]
end

subgraph group_account["Account setup"]
  node_welcome["Welcome"]
  node_login["Login<br/>[login_screen.dart]"]
  node_role["Role selection"]
  node_company["Company registration"]
  node_driver["Driver registration"]
end

subgraph group_freight["Freight workflow"]
  node_freight_list["Freight listings"]
  node_freight_detail["Freight details"]
  node_freight_confirm["Freight confirmation"]
  node_route_model["Route model<br/>[route_model.dart]"]
  node_success["Success dialog"]
end

subgraph group_maps["Maps and places"]
  node_map["Map screen<br/>[map_screen.dart]"]
  node_place_search["Place search"]
  node_place_model["Place suggestion"]
  node_geocoding["Geocoding"]
  node_location["Location service"]
  node_routing["Routing service"]
  node_search_bar["Floating search bar"]
end

subgraph group_support["Communication and profile"]
  node_chat_list["Chat list"]
  node_chat_detail["Chat detail"]
  node_profile["Profile"]
  node_settings["Settings"]
end

node_user(("App user"))

click node_app "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/main.dart"
click node_welcome "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/welcome_screen.dart"
click node_login "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/login_screen.dart"
click node_role "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/role_selection_screen.dart"
click node_company "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/register_company_screen.dart"
click node_driver "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/register_driver_screen.dart"
click node_freight_list "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_list_screen.dart"
click node_freight_detail "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_detail_screen.dart"
click node_freight_confirm "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_confirmation_screen.dart"
click node_route_model "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/models/route_model.dart"
click node_map "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/map_screen.dart"
click node_place_search "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/place_search_screen.dart"
click node_place_model "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/models/place_suggestion.dart"
click node_geocoding "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/geocoding_service.dart"
click node_location "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/location_service.dart"
click node_routing "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/routing_service.dart"
click node_chat_list "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/chat_list_screen.dart"
click node_chat_detail "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/chat_detail_screen.dart"
click node_profile "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/profile_screen.dart"
click node_settings "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/settings_screen.dart"
click node_bottom_nav "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/widgets/custom_bottom_nav_bar.dart"
click node_search_bar "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/widgets/floating_search_bar.dart"
click node_success "https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/success_dialog.dart"

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_app,node_bottom_nav,node_user toneBlue
class node_welcome,node_login,node_role,node_company,node_driver toneAmber
class node_freight_list,node_freight_detail,node_freight_confirm,node_route_model,node_success toneMint
class node_map,node_place_search,node_place_model,node_geocoding,node_location,node_routing,node_search_bar toneRose
class node_chat_list,node_chat_detail,node_profile,node_settings toneIndigo
```

## Components

### App entry

- [Flutter app](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/main.dart): `lib/main.dart`
- [Bottom navigation](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/widgets/custom_bottom_nav_bar.dart): `lib/widgets/custom_bottom_nav_bar.dart`

### Account setup

- [Welcome](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/welcome_screen.dart): `lib/screens/welcome_screen.dart`
- [Login](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/login_screen.dart): `lib/screens/login_screen.dart`
- [Role selection](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/role_selection_screen.dart): `lib/screens/role_selection_screen.dart`
- [Company registration](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/register_company_screen.dart): `lib/screens/register_company_screen.dart`
- [Driver registration](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/register_driver_screen.dart): `lib/screens/register_driver_screen.dart`

### Freight workflow

- [Freight listings](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_list_screen.dart): `lib/screens/freight_list_screen.dart`
- [Freight details](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_detail_screen.dart): `lib/screens/freight_detail_screen.dart`
- [Freight confirmation](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/freight_confirmation_screen.dart): `lib/screens/freight_confirmation_screen.dart`
- [Route model](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/models/route_model.dart): `lib/models/route_model.dart`
- [Success dialog](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/success_dialog.dart): `lib/screens/success_dialog.dart`

### Maps and places

- [Map screen](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/map_screen.dart): `lib/screens/map_screen.dart`
- [Place search](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/place_search_screen.dart): `lib/screens/place_search_screen.dart`
- [Place suggestion](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/models/place_suggestion.dart): `lib/models/place_suggestion.dart`
- [Geocoding](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/geocoding_service.dart): `lib/services/geocoding_service.dart`
- [Location service](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/location_service.dart): `lib/services/location_service.dart`
- [Routing service](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/services/routing_service.dart): `lib/services/routing_service.dart`
- [Floating search bar](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/widgets/floating_search_bar.dart): `lib/widgets/floating_search_bar.dart`

### Communication and profile

- [Chat list](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/chat_list_screen.dart): `lib/screens/chat_list_screen.dart`
- [Chat detail](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/chat_detail_screen.dart): `lib/screens/chat_detail_screen.dart`
- [Profile](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/profile_screen.dart): `lib/screens/profile_screen.dart`
- [Settings](https://github.com/trajetto-pi/trajetto-frontend/blob/main/lib/screens/settings_screen.dart): `lib/screens/settings_screen.dart`

### Other components

- **App user**
