# hassio-addons/repository architecture

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

- Interactive diagram: https://gitdiagram.com/hassio-addons/repository
- Repository: https://github.com/hassio-addons/repository

## Overview

This repository is a catalog of Home Assistant community apps, not the implementations of the listed apps. A user discovers the repository in Home Assistant’s app store, selects an app, and Home Assistant uses that app’s repository metadata and configuration to install it. README.md documents the catalog’s major capabilities; the sampled source did not include app runtime code, so internal runtime relationships are not shown.

Main entry points: [`README.md`](https://github.com/hassio-addons/repository/blob/master/README.md) (Repository overview), [`repository.json`](https://github.com/hassio-addons/repository/blob/master/repository.json) (App repository index), [`actual-budget/config.yaml`](https://github.com/hassio-addons/repository/blob/master/actual-budget/config.yaml) (App configurations), [`actual-budget/DOCS.md`](https://github.com/hassio-addons/repository/blob/master/actual-budget/DOCS.md) (App documentation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog and setup"]
  node_readme["Repository overview<br/>[README.md]"]
  node_index["App repository index<br/>[repository.json]"]
  node_app_configs["App configurations<br/>[config.yaml]"]
  node_app_docs["App documentation<br/>[DOCS.md]"]
end

subgraph group_home["Home and productivity"]
  node_budget["Budgeting and household"]
  node_home_tools["Home tools and automation"]
  node_home_content["Books and recipes"]
  node_home_files["Files and knowledge"]
end

subgraph group_media["Media and downloads"]
  node_media_servers["Media servers"]
  node_media_requests["Media requests"]
  node_media_management["Media management"]
  node_media_downloads["Media downloads"]
end

subgraph group_platform["Network and platform"]
  node_network_services["Network services"]
  node_monitoring["Monitoring and metrics"]
  node_messaging["MQTT services"]
  node_remote_access["Remote access"]
end

node_user(("Home Assistant user"))
node_store["Home Assistant app store"]

node_user -->|"browses apps"| node_store
node_store -->|"reads catalog"| node_index
node_store -->|"reads app config"| node_app_configs
node_readme -->|"describes repository"| node_user
node_store -->|"links documentation"| node_app_docs

click node_readme "https://github.com/hassio-addons/repository/blob/master/README.md"
click node_index "https://github.com/hassio-addons/repository/blob/master/repository.json"
click node_app_configs "https://github.com/hassio-addons/repository/blob/master/actual-budget/config.yaml"
click node_app_docs "https://github.com/hassio-addons/repository/blob/master/actual-budget/DOCS.md"
click node_budget "https://github.com/hassio-addons/repository/tree/master/actual-budget"
click node_home_tools "https://github.com/hassio-addons/repository/tree/master/appdaemon"
click node_home_content "https://github.com/hassio-addons/repository/tree/master/calibre-web"
click node_home_files "https://github.com/hassio-addons/repository/tree/master/file-explorer"
click node_media_servers "https://github.com/hassio-addons/repository/tree/master/jellyfin"
click node_media_requests "https://github.com/hassio-addons/repository/tree/master/overseerr"
click node_media_management "https://github.com/hassio-addons/repository/tree/master/radarr"
click node_media_downloads "https://github.com/hassio-addons/repository/tree/master/sabnzbd"
click node_network_services "https://github.com/hassio-addons/repository/tree/master/adguard"
click node_monitoring "https://github.com/hassio-addons/repository/tree/master/grafana"
click node_messaging "https://github.com/hassio-addons/repository/tree/master/emqx"
click node_remote_access "https://github.com/hassio-addons/repository/tree/master/ssh"

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,node_index,node_app_configs,node_app_docs,node_user toneBlue
class node_budget,node_home_tools,node_home_content,node_home_files toneAmber
class node_media_servers,node_media_requests,node_media_management,node_media_downloads toneMint
class node_network_services,node_monitoring,node_messaging,node_remote_access toneRose
class node_store toneIndigo
```

## Components

### Catalog and setup

- [Repository overview](https://github.com/hassio-addons/repository/blob/master/README.md): `README.md`
- [App repository index](https://github.com/hassio-addons/repository/blob/master/repository.json): `repository.json`
- [App configurations](https://github.com/hassio-addons/repository/blob/master/actual-budget/config.yaml): `actual-budget/config.yaml`
- [App documentation](https://github.com/hassio-addons/repository/blob/master/actual-budget/DOCS.md): `actual-budget/DOCS.md`

### Home and productivity

- [Budgeting and household](https://github.com/hassio-addons/repository/tree/master/actual-budget): `actual-budget`
- [Home tools and automation](https://github.com/hassio-addons/repository/tree/master/appdaemon): `appdaemon`
- [Books and recipes](https://github.com/hassio-addons/repository/tree/master/calibre-web): `calibre-web`
- [Files and knowledge](https://github.com/hassio-addons/repository/tree/master/file-explorer): `file-explorer`

### Media and downloads

- [Media servers](https://github.com/hassio-addons/repository/tree/master/jellyfin): `jellyfin`
- [Media requests](https://github.com/hassio-addons/repository/tree/master/overseerr): `overseerr`
- [Media management](https://github.com/hassio-addons/repository/tree/master/radarr): `radarr`
- [Media downloads](https://github.com/hassio-addons/repository/tree/master/sabnzbd): `sabnzbd`

### Network and platform

- [Network services](https://github.com/hassio-addons/repository/tree/master/adguard): `adguard`
- [Monitoring and metrics](https://github.com/hassio-addons/repository/tree/master/grafana): `grafana`
- [MQTT services](https://github.com/hassio-addons/repository/tree/master/emqx): `emqx`
- [Remote access](https://github.com/hassio-addons/repository/tree/master/ssh): `ssh`

### Other components

- **Home Assistant user**
- **Home Assistant app store**

## Connections

- Home Assistant user → Home Assistant app store: browses apps
- Home Assistant app store → App repository index: reads catalog
- Home Assistant app store → App configurations: reads app config
- Repository overview → Home Assistant user: describes repository
- Home Assistant app store → App documentation: links documentation