# jaywcjlove/awesome-mac architecture

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

- Interactive diagram: https://gitdiagram.com/jaywcjlove/awesome-mac
- Repository: https://github.com/jaywcjlove/awesome-mac

## Overview

This repository is a curated directory of Mac apps and developer tools, presented as Markdown lists and exposed as localized JSON and feed files. The main user workflow is to browse a topic list and discover relevant apps; feed and package consumers can use the generated data. The supplied README excerpt and source sample do not expose the full catalog structure or implementation details, so the graph shows documented artifacts and avoids inferring internal calls.

Main entry points: [`package.json`](https://github.com/jaywcjlove/awesome-mac/blob/master/package.json) (JSON package exports), [`README.md`](https://github.com/jaywcjlove/awesome-mac/blob/master/README.md) (Mac app catalog), [`command-line-apps.md`](https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps.md) (Command-line apps), [`editor-plugin.md`](https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin.md) (Editor plugins)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Curated Catalog"]
  node_main["Mac app catalog<br/>[README.md]"]
  node_cli["Command-line apps"]
  node_editor["Editor plugins<br/>[editor-plugin.md]"]
end

subgraph group_locales["Localized Lists"]
  node_ja["Japanese catalog<br/>[README-ja.md]"]
  node_ko["Korean catalog<br/>[README-ko.md]"]
  node_zh["Chinese catalog<br/>[README-zh.md]"]
  node_cli_ja["Japanese CLI list"]
  node_cli_ko["Korean CLI list"]
  node_cli_zh["Chinese CLI list"]
  node_editor_ja["Japanese plugins"]
  node_editor_zh["Chinese plugins"]
end

subgraph group_feeds["Feed Artifacts"]
  node_feed_md["Feed source lists<br/>[feed.md]"]
  node_feed_xml["Feed documents<br/>[feed.xml]"]
  node_feed_ja["Japanese feed<br/>[feed-ja.md]"]
  node_feed_ja_xml["Japanese feed XML<br/>[feed-ja.xml]"]
  node_feed_ko["Korean feed<br/>[feed-ko.md]"]
  node_feed_ko_xml["Korean feed XML<br/>[feed-ko.xml]"]
  node_feed_zh["Chinese feed<br/>[feed-zh.md]"]
  node_feed_zh_xml["Chinese feed XML<br/>[feed-zh.xml]"]
end

subgraph group_data["Data Access"]
  node_package["JSON package exports<br/>[package.json]"]
  node_json["Generated catalog data"]
end

node_reader(("Catalog reader"))
node_subscriber(("Feed subscriber"))

node_reader -->|"browses"| node_main
node_reader -->|"browses"| node_cli
node_reader -->|"browses"| node_editor
node_reader -->|"browses"| node_ja
node_reader -->|"browses"| node_ko
node_reader -->|"browses"| node_zh
node_reader -->|"browses"| node_cli_ja
node_reader -->|"browses"| node_cli_ko
node_reader -->|"browses"| node_cli_zh
node_reader -->|"browses"| node_editor_ja
node_reader -->|"browses"| node_editor_zh
node_subscriber -->|"subscribes"| node_feed_xml
node_subscriber -->|"subscribes"| node_feed_ja_xml
node_subscriber -->|"subscribes"| node_feed_ko_xml
node_subscriber -->|"subscribes"| node_feed_zh_xml
node_package -->|"exports"| node_json

click node_main "https://github.com/jaywcjlove/awesome-mac/blob/master/README.md"
click node_cli "https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps.md"
click node_editor "https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin.md"
click node_ja "https://github.com/jaywcjlove/awesome-mac/blob/master/README-ja.md"
click node_ko "https://github.com/jaywcjlove/awesome-mac/blob/master/README-ko.md"
click node_zh "https://github.com/jaywcjlove/awesome-mac/blob/master/README-zh.md"
click node_cli_ja "https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-ja.md"
click node_cli_ko "https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-ko.md"
click node_cli_zh "https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-zh.md"
click node_editor_ja "https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin-ja.md"
click node_editor_zh "https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin-zh.md"
click node_feed_md "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed.md"
click node_feed_xml "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed.xml"
click node_feed_ja "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ja.md"
click node_feed_ja_xml "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ja.xml"
click node_feed_ko "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ko.md"
click node_feed_ko_xml "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ko.xml"
click node_feed_zh "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-zh.md"
click node_feed_zh_xml "https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-zh.xml"
click node_package "https://github.com/jaywcjlove/awesome-mac/blob/master/package.json"
click node_json "https://github.com/jaywcjlove/awesome-mac/tree/master/dist"

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_main,node_cli,node_editor toneBlue
class node_ja,node_ko,node_zh,node_cli_ja,node_cli_ko,node_cli_zh,node_editor_ja,node_editor_zh toneAmber
class node_feed_md,node_feed_xml,node_feed_ja,node_feed_ja_xml,node_feed_ko,node_feed_ko_xml,node_feed_zh,node_feed_zh_xml toneMint
class node_package,node_json toneRose
class node_reader,node_subscriber toneIndigo
```

## Components

### Curated Catalog

- [Mac app catalog](https://github.com/jaywcjlove/awesome-mac/blob/master/README.md): `README.md`
- [Command-line apps](https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps.md): `command-line-apps.md`
- [Editor plugins](https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin.md): `editor-plugin.md`

### Localized Lists

- [Japanese catalog](https://github.com/jaywcjlove/awesome-mac/blob/master/README-ja.md): `README-ja.md`
- [Korean catalog](https://github.com/jaywcjlove/awesome-mac/blob/master/README-ko.md): `README-ko.md`
- [Chinese catalog](https://github.com/jaywcjlove/awesome-mac/blob/master/README-zh.md): `README-zh.md`
- [Japanese CLI list](https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-ja.md): `command-line-apps-ja.md`
- [Korean CLI list](https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-ko.md): `command-line-apps-ko.md`
- [Chinese CLI list](https://github.com/jaywcjlove/awesome-mac/blob/master/command-line-apps-zh.md): `command-line-apps-zh.md`
- [Japanese plugins](https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin-ja.md): `editor-plugin-ja.md`
- [Chinese plugins](https://github.com/jaywcjlove/awesome-mac/blob/master/editor-plugin-zh.md): `editor-plugin-zh.md`

### Feed Artifacts

- [Feed source lists](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed.md): `feed/feed.md`
- [Feed documents](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed.xml): `feed/feed.xml`
- [Japanese feed](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ja.md): `feed/feed-ja.md`
- [Japanese feed XML](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ja.xml): `feed/feed-ja.xml`
- [Korean feed](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ko.md): `feed/feed-ko.md`
- [Korean feed XML](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-ko.xml): `feed/feed-ko.xml`
- [Chinese feed](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-zh.md): `feed/feed-zh.md`
- [Chinese feed XML](https://github.com/jaywcjlove/awesome-mac/blob/master/feed/feed-zh.xml): `feed/feed-zh.xml`

### Data Access

- [JSON package exports](https://github.com/jaywcjlove/awesome-mac/blob/master/package.json): `package.json`
- [Generated catalog data](https://github.com/jaywcjlove/awesome-mac/tree/master/dist): `dist`

### Other components

- **Catalog reader**
- **Feed subscriber**

## Connections

- Catalog reader → Mac app catalog: browses
- Catalog reader → Command-line apps: browses
- Catalog reader → Editor plugins: browses
- Catalog reader → Japanese catalog: browses
- Catalog reader → Korean catalog: browses
- Catalog reader → Chinese catalog: browses
- Catalog reader → Japanese CLI list: browses
- Catalog reader → Korean CLI list: browses
- Catalog reader → Chinese CLI list: browses
- Catalog reader → Japanese plugins: browses
- Catalog reader → Chinese plugins: browses
- Feed subscriber → Feed documents: subscribes
- Feed subscriber → Japanese feed XML: subscribes
- Feed subscriber → Korean feed XML: subscribes
- Feed subscriber → Chinese feed XML: subscribes
- JSON package exports → Generated catalog data: exports