# ammaralsalahi/car-market-motora architecture

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

- Interactive diagram: https://gitdiagram.com/ammaralsalahi/car-market-motora
- Repository: https://github.com/ammaralsalahi/car-market-motora

## Overview

MOTORA is a Flutter car marketplace connecting car buyers and dealerships. The customer journey is to enter or browse as a guest, discover and inspect cars, save favorites, then contact dealerships through inquiries and chat; customers can also access notifications. Dealerships can create accounts, manage dealership details, and publish vehicle listings. The graph uses README-described capabilities and feature paths; Dart implementation details and call relationships were not sampled, so edges show documented product flow rather than verified code calls.

Main entry points: [`lib/main.dart`](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/main.dart) (App entry), [`lib/features/home/presentation/pages/home_page.dart`](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/presentation/pages/home_page.dart) (Car discovery), [`lib/features/inquiries`](https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/inquiries) (Inquiries), [`lib/features/dealership/presentation/pages/dealership_dashboard_page.dart`](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealership_dashboard_page.dart) (Dealer management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter app"]
  node_app_entry["App entry<br/>[main.dart]"]
end

subgraph group_customer["Customer features"]
  node_auth["Authentication"]
  node_car_browse["Car discovery<br/>[home_page.dart]"]
  node_car_details["Car details"]
  node_favorites["Favorites"]
  node_inquiries["Inquiries"]
  node_chat["Dealership chat<br/>[chat_page.dart]"]
  node_notifications["Notifications"]
  node_dealerships["Dealership directory"]
end

subgraph group_dealer["Dealership features"]
  node_dealer_application["Dealership signup"]
  node_dealer_dashboard["Dealer management"]
  node_listing_editor["Vehicle listings<br/>[add_car_page.dart]"]
end

subgraph group_data["Data services"]
  node_cars_service["Car data<br/>[cars_service.dart]"]
  node_favorites_service["Favorites data"]
  node_inquiries_service["Inquiry data"]
  node_dealership_service["Dealership data"]
end

node_customer_actor(("Customer"))
node_dealer_actor(("Dealership user"))
node_supabase[("Supabase backend")]

node_customer_actor -->|"opens"| node_app_entry
node_app_entry -->|"offers"| node_auth
node_app_entry -->|"offers"| node_car_browse
node_car_browse -->|"inspect cars"| node_car_details
node_car_details -->|"save favorites"| node_favorites
node_customer_actor -->|"contacts dealers"| node_inquiries
node_inquiries -->|"chat with dealers"| node_chat
node_customer_actor -->|"accesses"| node_notifications
node_customer_actor -->|"browses"| node_dealerships
node_dealer_actor -->|"creates account"| node_dealer_application
node_dealer_actor -->|"manages dealership"| node_dealer_dashboard
node_dealer_dashboard -->|"publishes listings"| node_listing_editor
node_car_browse -.->|"loads cars"| node_cars_service
node_favorites -.->|"uses data"| node_favorites_service
node_inquiries -.->|"uses data"| node_inquiries_service
node_dealer_dashboard -.->|"uses data"| node_dealership_service
node_cars_service -.->|"backend access"| node_supabase
node_favorites_service -.->|"backend access"| node_supabase
node_inquiries_service -.->|"backend access"| node_supabase
node_dealership_service -.->|"backend access"| node_supabase

click node_app_entry "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/main.dart"
click node_auth "https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/auth"
click node_car_browse "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/presentation/pages/home_page.dart"
click node_car_details "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/presentation/pages/car_details_page.dart"
click node_favorites "https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/favorites"
click node_inquiries "https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/inquiries"
click node_chat "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/inquiries/presentation/pages/chat_page.dart"
click node_notifications "https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/notifications"
click node_dealerships "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealerships_page.dart"
click node_dealer_application "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealership_application_page.dart"
click node_dealer_dashboard "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealership_dashboard_page.dart"
click node_listing_editor "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/add_car_page.dart"
click node_cars_service "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/data/cars_service.dart"
click node_favorites_service "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/favorites/data/favorites_service.dart"
click node_inquiries_service "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/inquiries/data/inquiries_service.dart"
click node_dealership_service "https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/data/dealership_management_service.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_entry,node_dealer_actor toneBlue
class node_auth,node_car_browse,node_car_details,node_favorites,node_inquiries,node_chat,node_notifications,node_dealerships,node_supabase toneAmber
class node_dealer_application,node_dealer_dashboard,node_listing_editor toneMint
class node_cars_service,node_favorites_service,node_inquiries_service,node_dealership_service toneRose
class node_customer_actor toneIndigo
```

## Components

### Flutter app

- [App entry](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/main.dart): `lib/main.dart`

### Customer features

- [Authentication](https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/auth): `lib/features/auth`
- [Car discovery](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/presentation/pages/home_page.dart): `lib/features/home/presentation/pages/home_page.dart`
- [Car details](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/presentation/pages/car_details_page.dart): `lib/features/home/presentation/pages/car_details_page.dart`
- [Favorites](https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/favorites): `lib/features/favorites`
- [Inquiries](https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/inquiries): `lib/features/inquiries`
- [Dealership chat](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/inquiries/presentation/pages/chat_page.dart): `lib/features/inquiries/presentation/pages/chat_page.dart`
- [Notifications](https://github.com/ammaralsalahi/car-market-motora/tree/main/lib/features/notifications): `lib/features/notifications`
- [Dealership directory](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealerships_page.dart): `lib/features/dealership/presentation/pages/dealerships_page.dart`

### Dealership features

- [Dealership signup](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealership_application_page.dart): `lib/features/dealership/presentation/pages/dealership_application_page.dart`
- [Dealer management](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/dealership_dashboard_page.dart): `lib/features/dealership/presentation/pages/dealership_dashboard_page.dart`
- [Vehicle listings](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/presentation/pages/add_car_page.dart): `lib/features/dealership/presentation/pages/add_car_page.dart`

### Data services

- [Car data](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/home/data/cars_service.dart): `lib/features/home/data/cars_service.dart`
- [Favorites data](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/favorites/data/favorites_service.dart): `lib/features/favorites/data/favorites_service.dart`
- [Inquiry data](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/inquiries/data/inquiries_service.dart): `lib/features/inquiries/data/inquiries_service.dart`
- [Dealership data](https://github.com/ammaralsalahi/car-market-motora/blob/main/lib/features/dealership/data/dealership_management_service.dart): `lib/features/dealership/data/dealership_management_service.dart`

### Other components

- **Customer**
- **Dealership user**
- **Supabase backend**

## Connections

- Customer → App entry: opens (evidence: `README.md`)
- App entry → Authentication: offers (evidence: `README.md`)
- App entry → Car discovery: offers (evidence: `README.md`)
- Car discovery → Car details: inspect cars (evidence: `README.md`)
- Car details → Favorites: save favorites (evidence: `README.md`)
- Customer → Inquiries: contacts dealers (evidence: `README.md`)
- Inquiries → Dealership chat: chat with dealers (evidence: `README.md`)
- Customer → Notifications: accesses (evidence: `README.md`)
- Customer → Dealership directory: browses (evidence: `README.md`)
- Dealership user → Dealership signup: creates account (evidence: `README.md`)
- Dealership user → Dealer management: manages dealership (evidence: `README.md`)
- Dealer management → Vehicle listings: publishes listings (evidence: `README.md`)
- Car discovery → Car data: loads cars
- Favorites → Favorites data: uses data
- Inquiries → Inquiry data: uses data
- Dealer management → Dealership data: uses data
- Car data → Supabase backend: backend access (evidence: `README.md`)
- Favorites data → Supabase backend: backend access (evidence: `README.md`)
- Inquiry data → Supabase backend: backend access (evidence: `README.md`)
- Dealership data → Supabase backend: backend access (evidence: `README.md`)
