# frosty-aosp/vendor_frosty architecture

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

- Interactive diagram: https://gitdiagram.com/frosty-aosp/vendor_frosty
- Repository: https://github.com/frosty-aosp/vendor_frosty

## Overview

Frosty is an Android ROM configuration and customization repository: its README describes it as containing configuration files and modules. The apparent maintainer workflow is to select device or form-factor configuration and build a customized system image. The tree shows configuration, overlays, bundled media, and runtime modules, but the README and sampled source do not establish how the build connects them; those relationships are therefore not asserted here.

Main entry points: [`adaway/generate.py`](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/adaway/generate.py) (Ad host generation), [`disable-overlays/main.cpp`](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/disable-overlays/main.cpp) (OverlayFS control), [`libbfqio/bfqio.c`](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/libbfqio/bfqio.c) (BFQ I/O priority), [`adaway/.hosts`](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/adaway/.hosts) (Hosts sources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Product configuration"]
  node_board_config["Board configuration"]
  node_product_variants["Product variants<br/>[common.mk]"]
  node_package_selection["Package selection<br/>[frosty_packages.mk]"]
  node_release_settings["Release settings"]
  node_permission_config["Permissions"]
end

subgraph group_customization["System customization"]
  node_resource_overlays["Resource overlays"]
  node_ad_host_generation["Ad host generation<br/>[generate.py]"]
  node_hosts_inputs["Hosts sources<br/>[.hosts]"]
  node_generated_hosts["Generated hosts file<br/>[.hosts]"]
end

subgraph group_resources["Bundled resources"]
  node_system_audio["System audio"]
  node_google_audio["Google audio"]
  node_boot_animation["Boot animation"]
  node_charger_ui["Charger UI"]
  node_prebuilt_assets["Prebuilt assets"]
end

subgraph group_runtime["Runtime modules"]
  node_overlay_disable["OverlayFS control<br/>[main.cpp]"]
  node_bfq_io["BFQ I/O priority<br/>[bfqio.c]"]
  node_bfq_api["BFQ I/O API<br/>[bfqio.h]"]
end

node_maintainer(("ROM maintainer"))
node_device_partitions[("Device partition metadata")]
node_bfq_cgroups[("BFQ I/O cgroups")]

node_ad_host_generation -->|"reads sources"| node_hosts_inputs
node_ad_host_generation -->|"writes hosts"| node_generated_hosts
node_overlay_disable -->|"updates metadata"| node_device_partitions
node_bfq_io -->|"writes task IDs"| node_bfq_cgroups

click node_board_config "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/BoardConfigLineage.mk"
click node_product_variants "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/common.mk"
click node_package_selection "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/frosty_packages.mk"
click node_release_settings "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/release"
click node_permission_config "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/config/permissions"
click node_resource_overlays "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/overlay"
click node_ad_host_generation "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/adaway/generate.py"
click node_overlay_disable "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/disable-overlays/main.cpp"
click node_bfq_io "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/libbfqio/bfqio.c"
click node_bfq_api "https://github.com/frosty-aosp/vendor_frosty/blob/ananas/libbfqio/include/bfqio/bfqio.h"
click node_system_audio "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/audio"
click node_google_audio "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/google"
click node_boot_animation "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/bootanimation"
click node_charger_ui "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/charger"
click node_prebuilt_assets "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/prebuilt/common"
click node_hosts_inputs "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/adaway/.hosts"
click node_generated_hosts "https://github.com/frosty-aosp/vendor_frosty/tree/ananas/adaway/.hosts"

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_board_config,node_product_variants,node_package_selection,node_release_settings,node_permission_config toneBlue
class node_resource_overlays,node_ad_host_generation,node_hosts_inputs,node_generated_hosts,node_device_partitions,node_bfq_cgroups toneAmber
class node_system_audio,node_google_audio,node_boot_animation,node_charger_ui,node_prebuilt_assets toneMint
class node_overlay_disable,node_bfq_io,node_bfq_api toneRose
class node_maintainer toneIndigo
```

## Components

### Product configuration

- [Board configuration](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/BoardConfigLineage.mk): `config/BoardConfigLineage.mk`
- [Product variants](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/common.mk): `config/common.mk`
- [Package selection](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/config/frosty_packages.mk): `config/frosty_packages.mk`
- [Release settings](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/release): `release`
- [Permissions](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/config/permissions): `config/permissions`

### System customization

- [Resource overlays](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/overlay): `overlay`
- [Ad host generation](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/adaway/generate.py): `adaway/generate.py`
- [Hosts sources](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/adaway/.hosts): `adaway/.hosts`
- [Generated hosts file](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/adaway/.hosts): `adaway/.hosts`

### Bundled resources

- [System audio](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/audio): `audio`
- [Google audio](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/google): `google`
- [Boot animation](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/bootanimation): `bootanimation`
- [Charger UI](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/charger): `charger`
- [Prebuilt assets](https://github.com/frosty-aosp/vendor_frosty/tree/ananas/prebuilt/common): `prebuilt/common`

### Runtime modules

- [OverlayFS control](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/disable-overlays/main.cpp): `disable-overlays/main.cpp`
- [BFQ I/O priority](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/libbfqio/bfqio.c): `libbfqio/bfqio.c`
- [BFQ I/O API](https://github.com/frosty-aosp/vendor_frosty/blob/ananas/libbfqio/include/bfqio/bfqio.h): `libbfqio/include/bfqio/bfqio.h`

### Other components

- **ROM maintainer**
- **Device partition metadata**
- **BFQ I/O cgroups**

## Connections

- Ad host generation → Hosts sources: reads sources (evidence: `adaway/generate.py`)
- Ad host generation → Generated hosts file: writes hosts (evidence: `adaway/generate.py`)
- OverlayFS control → Device partition metadata: updates metadata (evidence: `disable-overlays/main.cpp`)
- BFQ I/O priority → BFQ I/O cgroups: writes task IDs (evidence: `libbfqio/bfqio.c`)
