# trendyol/android-guidelines architecture

> Architecture diagram of the GitHub repository trendyol/android-guidelines, 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/trendyol/android-guidelines
- Repository: https://github.com/trendyol/android-guidelines

## Overview

This repository is a documentation toolkit for Trendyol Android development, not an application runtime. An engineer starts at the README, then consults relevant architecture, coding, module, resource, review, or testing guidance; Android Studio templates and architecture decision records provide reusable examples and recorded decisions. The README names these capabilities, but no source excerpts establish a prescribed sequence or interactions among them, so the graph shows only its documented links.

Main entry points: [`README.md`](https://github.com/trendyol/android-guidelines/blob/master/README.md) (Guideline index), [`package_guideline/package_guideline.md`](https://github.com/trendyol/android-guidelines/blob/master/package_guideline/package_guideline.md) (Package guidance), [`app_architecture_guideline/app_architecture_guideline.md`](https://github.com/trendyol/android-guidelines/blob/master/app_architecture_guideline/app_architecture_guideline.md) (App architecture), [`module_guideline/module_guideline.md`](https://github.com/trendyol/android-guidelines/blob/master/module_guideline/module_guideline.md) (Module guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry point"]
  node_readme["Guideline index<br/>[README.md]"]
end

subgraph group_architecture["Architecture guidance"]
  node_package["Package guidance"]
  node_app_arch["App architecture"]
  node_module["Module guidance"]
end

subgraph group_standards["Development standards"]
  node_code_style["Code style"]
  node_resource["Resource naming"]
end

subgraph group_tooling["Templates and decisions"]
  node_templates["Studio templates"]
  node_adrs["Architecture decisions"]
  node_ci_cd["CI/CD guidance<br/>[ci_cd.md]"]
  node_oss["Android OSS"]
end

subgraph group_quality["Quality guidance"]
  node_review["Code review"]
  node_ui_tests["UI test guidance"]
  node_unit_tests["Unit test guidance"]
  node_viewmodel["ViewModel naming"]
end

node_engineer(("Android engineer"))

node_engineer -->|"consults"| node_readme
node_readme -->|"links to"| node_package
node_readme -->|"links to"| node_app_arch
node_readme -->|"links to"| node_module
node_readme -->|"links to"| node_code_style
node_readme -->|"links to"| node_resource
node_readme -->|"links to"| node_templates
node_readme -->|"links to"| node_adrs
node_readme -->|"links to"| node_review
node_readme -->|"links to"| node_ui_tests
node_readme -->|"links to"| node_unit_tests
node_readme -->|"links to"| node_oss

click node_readme "https://github.com/trendyol/android-guidelines/blob/master/README.md"
click node_package "https://github.com/trendyol/android-guidelines/blob/master/package_guideline/package_guideline.md"
click node_app_arch "https://github.com/trendyol/android-guidelines/blob/master/app_architecture_guideline/app_architecture_guideline.md"
click node_module "https://github.com/trendyol/android-guidelines/blob/master/module_guideline/module_guideline.md"
click node_code_style "https://github.com/trendyol/android-guidelines/blob/master/code_style_guideline/code_style_guideline.md"
click node_resource "https://github.com/trendyol/android-guidelines/blob/master/resource_naming_guideline/resource_naming_guideline.md"
click node_templates "https://github.com/trendyol/android-guidelines/blob/master/android_studio_live_templates/android_studio_live_templates.md"
click node_adrs "https://github.com/trendyol/android-guidelines/blob/master/architecture_decision_records/architecture_decision_records.md"
click node_ci_cd "https://github.com/trendyol/android-guidelines/blob/master/ci_cd/ci_cd.md"
click node_review "https://github.com/trendyol/android-guidelines/blob/master/code_review_guideline/code_review_guideline.md"
click node_ui_tests "https://github.com/trendyol/android-guidelines/blob/master/ui_test_guideline/ui_test_guideline.md"
click node_unit_tests "https://github.com/trendyol/android-guidelines/blob/master/unit_test_guideline/unit_test_guideline.md"
click node_viewmodel "https://github.com/trendyol/android-guidelines/blob/master/viewmodel_fields_naming_guideline/viewmodel_fields_naming_guideline.md"
click node_oss "https://github.com/trendyol/android-guidelines/blob/master/trendyol_android_oss/trendyol_android_oss.md"

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_readme toneBlue
class node_package,node_app_arch,node_module toneAmber
class node_code_style,node_resource toneMint
class node_templates,node_adrs,node_ci_cd,node_oss toneRose
class node_review,node_ui_tests,node_unit_tests,node_viewmodel,node_engineer toneIndigo
```

## Components

### Entry point

- [Guideline index](https://github.com/trendyol/android-guidelines/blob/master/README.md): `README.md`

### Architecture guidance

- [Package guidance](https://github.com/trendyol/android-guidelines/blob/master/package_guideline/package_guideline.md): `package_guideline/package_guideline.md`
- [App architecture](https://github.com/trendyol/android-guidelines/blob/master/app_architecture_guideline/app_architecture_guideline.md): `app_architecture_guideline/app_architecture_guideline.md`
- [Module guidance](https://github.com/trendyol/android-guidelines/blob/master/module_guideline/module_guideline.md): `module_guideline/module_guideline.md`

### Development standards

- [Code style](https://github.com/trendyol/android-guidelines/blob/master/code_style_guideline/code_style_guideline.md): `code_style_guideline/code_style_guideline.md`
- [Resource naming](https://github.com/trendyol/android-guidelines/blob/master/resource_naming_guideline/resource_naming_guideline.md): `resource_naming_guideline/resource_naming_guideline.md`

### Templates and decisions

- [Studio templates](https://github.com/trendyol/android-guidelines/blob/master/android_studio_live_templates/android_studio_live_templates.md): `android_studio_live_templates/android_studio_live_templates.md`
- [Architecture decisions](https://github.com/trendyol/android-guidelines/blob/master/architecture_decision_records/architecture_decision_records.md): `architecture_decision_records/architecture_decision_records.md`
- [CI/CD guidance](https://github.com/trendyol/android-guidelines/blob/master/ci_cd/ci_cd.md): `ci_cd/ci_cd.md`
- [Android OSS](https://github.com/trendyol/android-guidelines/blob/master/trendyol_android_oss/trendyol_android_oss.md): `trendyol_android_oss/trendyol_android_oss.md`

### Quality guidance

- [Code review](https://github.com/trendyol/android-guidelines/blob/master/code_review_guideline/code_review_guideline.md): `code_review_guideline/code_review_guideline.md`
- [UI test guidance](https://github.com/trendyol/android-guidelines/blob/master/ui_test_guideline/ui_test_guideline.md): `ui_test_guideline/ui_test_guideline.md`
- [Unit test guidance](https://github.com/trendyol/android-guidelines/blob/master/unit_test_guideline/unit_test_guideline.md): `unit_test_guideline/unit_test_guideline.md`
- [ViewModel naming](https://github.com/trendyol/android-guidelines/blob/master/viewmodel_fields_naming_guideline/viewmodel_fields_naming_guideline.md): `viewmodel_fields_naming_guideline/viewmodel_fields_naming_guideline.md`

### Other components

- **Android engineer**

## Connections

- Android engineer → Guideline index: consults (evidence: `README.md`)
- Guideline index → Package guidance: links to (evidence: `README.md`)
- Guideline index → App architecture: links to (evidence: `README.md`)
- Guideline index → Module guidance: links to (evidence: `README.md`)
- Guideline index → Code style: links to (evidence: `README.md`)
- Guideline index → Resource naming: links to (evidence: `README.md`)
- Guideline index → Studio templates: links to (evidence: `README.md`)
- Guideline index → Architecture decisions: links to (evidence: `README.md`)
- Guideline index → Code review: links to (evidence: `README.md`)
- Guideline index → UI test guidance: links to (evidence: `README.md`)
- Guideline index → Unit test guidance: links to (evidence: `README.md`)
- Guideline index → Android OSS: links to (evidence: `README.md`)
