# keiyoushi/extensions architecture

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

- Interactive diagram: https://gitdiagram.com/keiyoushi/extensions
- Repository: https://github.com/keiyoushi/extensions

## Overview

This repository is a prebuilt Keiyoushi extension catalog and distribution site, rather than the extension source project. The documented user workflow is to add the repository using its index.pb, or manually download and update extensions from the listing page. The tree also contains catalog and release metadata artifacts, but no source excerpts or documentation establish how those files relate or are consumed, so those relationships are omitted.

Main entry points: [`index.pb`](https://github.com/keiyoushi/extensions/blob/repo/index.pb) (Repository index), [`index.html`](https://github.com/keiyoushi/extensions/blob/repo/index.html) (Extension listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_distribution["Catalog distribution"]
  node_repo_index["Repository index<br/>[index.pb]"]
  node_listing["Extension listing<br/>[index.html]"]
  node_catalog_json["Catalog metadata<br/>[index.json]"]
  node_repo_metadata["Repository metadata<br/>[repo.json]"]
  node_release_assets["Release assets"]
  node_icon["Repository icon"]
end

node_user(("Extension user"))

node_user -->|"adds repository"| node_repo_index
node_user -->|"downloads extensions"| node_listing

click node_repo_index "https://github.com/keiyoushi/extensions/blob/repo/index.pb"
click node_listing "https://github.com/keiyoushi/extensions/blob/repo/index.html"
click node_catalog_json "https://github.com/keiyoushi/extensions/blob/repo/index.json"
click node_repo_metadata "https://github.com/keiyoushi/extensions/blob/repo/repo.json"
click node_release_assets "https://github.com/keiyoushi/extensions/blob/repo/release-assets.json"
click node_icon "https://github.com/keiyoushi/extensions/tree/repo/icon"

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_repo_index,node_listing,node_catalog_json,node_repo_metadata,node_release_assets,node_icon,node_user toneBlue
```

## Components

### Catalog distribution

- [Repository index](https://github.com/keiyoushi/extensions/blob/repo/index.pb): `index.pb`
- [Extension listing](https://github.com/keiyoushi/extensions/blob/repo/index.html): `index.html`
- [Catalog metadata](https://github.com/keiyoushi/extensions/blob/repo/index.json): `index.json`
- [Repository metadata](https://github.com/keiyoushi/extensions/blob/repo/repo.json): `repo.json`
- [Release assets](https://github.com/keiyoushi/extensions/blob/repo/release-assets.json): `release-assets.json`
- [Repository icon](https://github.com/keiyoushi/extensions/tree/repo/icon): `icon`

### Other components

- **Extension user**

## Connections

- Extension user → Repository index: adds repository (evidence: `README.md`)
- Extension user → Extension listing: downloads extensions (evidence: `README.md`)
