# akhileshgulia72-dotcom/gta-6-companion-app architecture

> Architecture diagram of the GitHub repository akhileshgulia72-dotcom/gta-6-companion-app, 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/akhileshgulia72-dotcom/gta-6-companion-app
- Repository: https://github.com/akhileshgulia72-dotcom/gta-6-companion-app

## Overview

This is a Flutter GTA 6 companion app. Users enter through the app UI to browse release information and news, explore characters, vehicles and maps, take quizzes, and use a lucky draw. The README also describes Firebase and rewarded ads; the tree contains corresponding service modules, but their runtime wiring is not shown in the excerpts. Dashed, unevidenced links mark likely entry or integration relationships rather than verified calls.

Main entry points: [`lib/home_screen.dart`](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/home_screen.dart) (Home screen), [`lib/main.dart`](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/main.dart) (App entry), [`lib/news_screen.dart`](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_screen.dart) (News), [`lib/news_service.dart`](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_service.dart) (News service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_entry["App entry<br/>[main.dart]"]
  node_splash["Splash screen<br/>[splash_screen.dart]"]
  node_home["Home screen<br/>[home_screen.dart]"]
end

subgraph group_content["Fan content"]
  node_news["News<br/>[news_screen.dart]"]
  node_news_service["News service<br/>[news_service.dart]"]
  node_characters["Characters<br/>[charaters.dart]"]
  node_vehicles["Vehicles"]
  node_vehicle_data["Vehicle service"]
  node_maps["Map exploration"]
end

subgraph group_activities["Interactive features"]
  node_quiz_home["Quiz home"]
  node_quiz["Quiz<br/>[quiz_screen.dart]"]
  node_questions["Quiz questions<br/>[questions.dart]"]
  node_lucky_draw["Lucky draw"]
end

subgraph group_services["App services"]
  node_firebase["Firebase API<br/>[firebase_api.dart]"]
  node_auth["Authentication<br/>[auth_service.dart]"]
  node_ads["Rewarded ads"]
end

subgraph group_platform["Native integrations"]
  node_native_ads["Native ad factory"]
end

node_user(("App user"))
node_ad_network["Google Mobile Ads"]
node_news_api["News API"]

node_user -.->|"opens"| node_entry
node_entry -.->|"starts"| node_splash
node_entry -.->|"shows"| node_home
node_home -.->|"opens"| node_news
node_news -.->|"loads news"| node_news_service
node_news_service -.->|"fetches"| node_news_api
node_home -.->|"opens"| node_characters
node_home -.->|"opens"| node_vehicles
node_vehicles -.->|"loads vehicles"| node_vehicle_data
node_home -.->|"opens"| node_maps
node_home -.->|"opens"| node_quiz_home
node_quiz_home -.->|"starts"| node_quiz
node_quiz -.->|"uses"| node_questions
node_home -.->|"opens"| node_lucky_draw
node_home -.->|"uses"| node_firebase
node_home -.->|"uses"| node_auth
node_home -.->|"uses"| node_ads
node_ads -.->|"requests ads"| node_ad_network
node_native_ads -->|"renders ads"| node_ad_network

click node_entry "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/main.dart"
click node_splash "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/splash_screen.dart"
click node_home "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/home_screen.dart"
click node_news "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_screen.dart"
click node_news_service "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_service.dart"
click node_characters "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/charaters.dart"
click node_vehicles "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/premium_vehicles_screen.dart"
click node_vehicle_data "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/services/vehicle_service.dart"
click node_maps "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/advanced_map_screen.dart"
click node_quiz_home "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/quiz_home_screen.dart"
click node_quiz "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/quiz_screen.dart"
click node_questions "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/questions.dart"
click node_lucky_draw "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/lucky_draw_screen.dart"
click node_firebase "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/firebase_api.dart"
click node_auth "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/services/auth_service.dart"
click node_ads "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/rewarded_ad_service.dart"
click node_native_ads "https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/android/app/src/main/kotlin/com/akhileshgulia/NewsNativeAdFactory.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_entry,node_splash,node_home,node_user toneBlue
class node_news,node_news_service,node_characters,node_vehicles,node_vehicle_data,node_maps toneAmber
class node_quiz_home,node_quiz,node_questions,node_lucky_draw,node_news_api toneMint
class node_firebase,node_auth,node_ads toneRose
class node_native_ads,node_ad_network toneIndigo
```

## Components

### App experience

- [App entry](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/main.dart): `lib/main.dart`
- [Splash screen](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/splash_screen.dart): `lib/splash_screen.dart`
- [Home screen](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/home_screen.dart): `lib/home_screen.dart`

### Fan content

- [News](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_screen.dart): `lib/news_screen.dart`
- [News service](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/news_service.dart): `lib/news_service.dart`
- [Characters](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/charaters.dart): `lib/charaters.dart`
- [Vehicles](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/premium_vehicles_screen.dart): `lib/premium_vehicles_screen.dart`
- [Vehicle service](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/services/vehicle_service.dart): `lib/services/vehicle_service.dart`
- [Map exploration](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/advanced_map_screen.dart): `lib/advanced_map_screen.dart`

### Interactive features

- [Quiz home](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/quiz_home_screen.dart): `lib/quiz_home_screen.dart`
- [Quiz](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/quiz_screen.dart): `lib/quiz_screen.dart`
- [Quiz questions](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/questions.dart): `lib/questions.dart`
- [Lucky draw](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/lucky_draw_screen.dart): `lib/lucky_draw_screen.dart`

### App services

- [Firebase API](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/firebase_api.dart): `lib/firebase_api.dart`
- [Authentication](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [Rewarded ads](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/lib/rewarded_ad_service.dart): `lib/rewarded_ad_service.dart`

### Native integrations

- [Native ad factory](https://github.com/akhileshgulia72-dotcom/gta-6-companion-app/blob/main/android/app/src/main/kotlin/com/akhileshgulia/NewsNativeAdFactory.kt): `android/app/src/main/kotlin/com/akhileshgulia/NewsNativeAdFactory.kt`

### Other components

- **App user**
- **Google Mobile Ads**
- **News API**

## Connections

- App user → App entry: opens
- App entry → Splash screen: starts
- App entry → Home screen: shows
- Home screen → News: opens
- News → News service: loads news
- News service → News API: fetches
- Home screen → Characters: opens
- Home screen → Vehicles: opens
- Vehicles → Vehicle service: loads vehicles
- Home screen → Map exploration: opens
- Home screen → Quiz home: opens
- Quiz home → Quiz: starts
- Quiz → Quiz questions: uses
- Home screen → Lucky draw: opens
- Home screen → Firebase API: uses
- Home screen → Authentication: uses
- Home screen → Rewarded ads: uses
- Rewarded ads → Google Mobile Ads: requests ads
- Native ad factory → Google Mobile Ads: renders ads (evidence: `android/app/src/main/kotlin/com/akhileshgulia/NewsNativeAdFactory.kt`)
