# shmykelsa/aaad architecture

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

- Interactive diagram: https://gitdiagram.com/shmykelsa/aaad
- Repository: https://github.com/shmykelsa/aaad

## Overview

AAAD is an Android app downloader for third-party Android Auto apps, with in-app installation intended to make them available without root. The README describes the main select-download-install journey, but the corresponding catalog and download implementation is not present in the supplied tree, so that subsystem is represented at its enclosing source directory. The sampled code shows separate PRO purchase, promo-code activation, and license-transfer flows. Some runtime components are unsampled; edges reflect only README statements or relationships visible in the provided source excerpts/index.

Main entry points: [`app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt`](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt) (PRO payment), [`app/src/main/java/com/legs/appsforaa/EnterProCode.java`](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/EnterProCode.java) (Promo code entry), [`app/src/main/java/com/legs/appsforaa`](https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa) (AAAD app flow), [`app/src/main/java/com/legs/appsforaa/TransferLicense.java`](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/TransferLicense.java) (License transfer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_download["App downloads"]
  node_aaad["AAAD app flow"]
  node_catalog["App selection"]
  node_download_install["Download and install"]
end

subgraph group_license["PRO licensing"]
  node_payment["PRO payment"]
  node_pro_code["Promo code entry<br/>[EnterProCode.java]"]
  node_license_transfer["License transfer"]
end

subgraph group_support["Dialogs and utilities"]
  node_about_dialog["About and privacy<br/>[AboutDialog.java]"]
  node_bottom_dialog["Bottom dialog<br/>[BottomDialog.java]"]
  node_dialog_utils["Dialog styling<br/>[UtilsLibrary.java]"]
  node_version["Version comparison<br/>[Version.java]"]
  node_user_model["User model<br/>[User.java]"]
end

node_user(("Phone user"))
node_android_installer["Android installer"]
node_android_auto["Android Auto"]
node_stripe["Stripe services"]
node_firebase[("Firebase data")]

node_user -->|"uses"| node_aaad
node_aaad -->|"offers selection"| node_catalog
node_catalog -->|"starts download"| node_download_install
node_download_install -->|"installs APK"| node_android_installer
node_android_installer -->|"makes apps available"| node_android_auto
node_user -->|"opens PRO"| node_payment
node_payment -->|"requests payment"| node_stripe
node_payment -->|"checks and records"| node_firebase
node_payment -->|"opens code entry"| node_pro_code
node_pro_code -->|"validates and activates"| node_firebase
node_pro_code -->|"opens promotion"| node_payment
node_user -->|"transfers license"| node_license_transfer
node_license_transfer -->|"reads and updates"| node_firebase
node_user -.->|"views information"| node_about_dialog
node_bottom_dialog -->|"creates button styling"| node_dialog_utils

click node_aaad "https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa"
click node_catalog "https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa"
click node_download_install "https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa"
click node_payment "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt"
click node_pro_code "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/EnterProCode.java"
click node_license_transfer "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/TransferLicense.java"
click node_about_dialog "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/AboutDialog.java"
click node_bottom_dialog "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/BottomDialog.java"
click node_dialog_utils "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/UtilsLibrary.java"
click node_version "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/Version.java"
click node_user_model "https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/User.java"

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_aaad,node_catalog,node_download_install,node_user toneBlue
class node_payment,node_pro_code,node_license_transfer,node_firebase toneAmber
class node_about_dialog,node_bottom_dialog,node_dialog_utils,node_version,node_user_model toneMint
class node_android_installer,node_android_auto,node_stripe toneIndigo
```

## Components

### App downloads

- [AAAD app flow](https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa): `app/src/main/java/com/legs/appsforaa`
- [App selection](https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa): `app/src/main/java/com/legs/appsforaa`
- [Download and install](https://github.com/shmykelsa/aaad/tree/main/app/src/main/java/com/legs/appsforaa): `app/src/main/java/com/legs/appsforaa`

### PRO licensing

- [PRO payment](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt): `app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt`
- [Promo code entry](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/EnterProCode.java): `app/src/main/java/com/legs/appsforaa/EnterProCode.java`
- [License transfer](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/TransferLicense.java): `app/src/main/java/com/legs/appsforaa/TransferLicense.java`

### Dialogs and utilities

- [About and privacy](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/AboutDialog.java): `app/src/main/java/com/legs/appsforaa/AboutDialog.java`
- [Bottom dialog](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/BottomDialog.java): `app/src/main/java/com/legs/appsforaa/utils/BottomDialog.java`
- [Dialog styling](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/UtilsLibrary.java): `app/src/main/java/com/legs/appsforaa/utils/UtilsLibrary.java`
- [Version comparison](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/utils/Version.java): `app/src/main/java/com/legs/appsforaa/utils/Version.java`
- [User model](https://github.com/shmykelsa/aaad/blob/main/app/src/main/java/com/legs/appsforaa/User.java): `app/src/main/java/com/legs/appsforaa/User.java`

### Other components

- **Phone user**
- **Android installer**
- **Android Auto**
- **Stripe services**
- **Firebase data**

## Connections

- Phone user → AAAD app flow: uses (evidence: `README.md`)
- AAAD app flow → App selection: offers selection (evidence: `README.md`)
- App selection → Download and install: starts download (evidence: `README.md`)
- Download and install → Android installer: installs APK (evidence: `README.md`)
- Android installer → Android Auto: makes apps available (evidence: `README.md`)
- Phone user → PRO payment: opens PRO (evidence: `README.md`)
- PRO payment → Stripe services: requests payment (evidence: `app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt`)
- PRO payment → Firebase data: checks and records (evidence: `app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt`)
- PRO payment → Promo code entry: opens code entry (evidence: `app/src/main/java/com/legs/appsforaa/AboutPaymentActivity.kt`)
- Promo code entry → Firebase data: validates and activates (evidence: `app/src/main/java/com/legs/appsforaa/EnterProCode.java`)
- Promo code entry → PRO payment: opens promotion (evidence: `app/src/main/java/com/legs/appsforaa/EnterProCode.java`)
- Phone user → License transfer: transfers license (evidence: `app/src/main/java/com/legs/appsforaa/TransferLicense.java`)
- License transfer → Firebase data: reads and updates (evidence: `app/src/main/java/com/legs/appsforaa/TransferLicense.java`)
- Phone user → About and privacy: views information
- Bottom dialog → Dialog styling: creates button styling (evidence: `app/src/main/java/com/legs/appsforaa/utils/BottomDialog.java`)
