# hellogumbo/awesome-jev architecture

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

- Interactive diagram: https://gitdiagram.com/hellogumbo/awesome-jev
- Repository: https://github.com/hellogumbo/awesome-jev

## Overview

Awesome Jev is a curated, searchable directory of projects built on Jev. Visitors browse category sections, search and filter entries, and sort by stars or recency; contributors maintain the catalog, while discovery and refresh scripts support curation. The build script renders the catalog into the README and site. Source excerpts establish the curation calls and data access; the README documents the published site and daily star refresh, but the deployment and refresh scheduling implementation are not shown.

Main entry points: [`data/projects.json`](https://github.com/hellogumbo/awesome-jev/blob/main/data/projects.json) (Project catalog), [`scripts/discover.mjs`](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/discover.mjs) (Repository discovery), [`scripts/build.mjs`](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/build.mjs) (Directory renderer), [`scripts/refresh.mjs`](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/refresh.mjs) (Star refresh)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog data"]
  node_projects[("Project catalog<br/>[projects.json]")]
  node_exclusions["Excluded repositories<br/>[exclude.json]"]
end

subgraph group_curation["Curation tools"]
  node_discovery["Repository discovery<br/>[discover.mjs]"]
  node_classification["Category classifier<br/>[categorize.mjs]"]
  node_refresh["Star refresh<br/>[refresh.mjs]"]
  node_validator["Catalog validation<br/>[validate.mjs]"]
end

subgraph group_publishing["Directory publishing"]
  node_builder["Directory renderer<br/>[build.mjs]"]
  node_template["HTML template<br/>[template.html]"]
  node_readme["Generated README<br/>[README.md]"]
end

subgraph group_interface["Directory interface"]
  node_site["Searchable directory<br/>[app.js]"]
end

node_visitor(("Directory visitor"))
node_contributor(("Contributor"))
node_github{{"GitHub API"}}

node_visitor -->|"browses"| node_site
node_contributor -->|"edits"| node_projects
node_discovery -->|"searches"| node_github
node_discovery -->|"reads and adds"| node_projects
node_discovery -->|"checks"| node_exclusions
node_discovery -->|"classifies with"| node_classification
node_refresh -->|"fetches repository data"| node_github
node_refresh -->|"updates"| node_projects
node_validator -->|"validates"| node_projects
node_builder -->|"reads"| node_projects
node_builder -->|"reads"| node_template
node_builder -->|"renders"| node_readme
node_builder -->|"generates directory for"| node_site

click node_projects "https://github.com/hellogumbo/awesome-jev/blob/main/data/projects.json"
click node_exclusions "https://github.com/hellogumbo/awesome-jev/blob/main/data/exclude.json"
click node_discovery "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/discover.mjs"
click node_classification "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/categorize.mjs"
click node_refresh "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/refresh.mjs"
click node_builder "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/build.mjs"
click node_template "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/template.html"
click node_readme "https://github.com/hellogumbo/awesome-jev/blob/main/README.md"
click node_site "https://github.com/hellogumbo/awesome-jev/blob/main/site/app.js"
click node_validator "https://github.com/hellogumbo/awesome-jev/blob/main/scripts/validate.mjs"

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_projects,node_exclusions toneBlue
class node_discovery,node_classification,node_refresh,node_validator toneAmber
class node_builder,node_template,node_readme,node_github toneMint
class node_site toneRose
class node_visitor,node_contributor toneIndigo
```

## Components

### Catalog data

- [Project catalog](https://github.com/hellogumbo/awesome-jev/blob/main/data/projects.json): `data/projects.json`
- [Excluded repositories](https://github.com/hellogumbo/awesome-jev/blob/main/data/exclude.json): `data/exclude.json`

### Curation tools

- [Repository discovery](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/discover.mjs): `scripts/discover.mjs`
- [Category classifier](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/categorize.mjs): `scripts/categorize.mjs`
- [Star refresh](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/refresh.mjs): `scripts/refresh.mjs`
- [Catalog validation](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/validate.mjs): `scripts/validate.mjs`

### Directory publishing

- [Directory renderer](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/build.mjs): `scripts/build.mjs`
- [HTML template](https://github.com/hellogumbo/awesome-jev/blob/main/scripts/template.html): `scripts/template.html`
- [Generated README](https://github.com/hellogumbo/awesome-jev/blob/main/README.md): `README.md`

### Directory interface

- [Searchable directory](https://github.com/hellogumbo/awesome-jev/blob/main/site/app.js): `site/app.js`

### Other components

- **Directory visitor**
- **Contributor**
- **GitHub API**

## Connections

- Directory visitor → Searchable directory: browses (evidence: `README.md`)
- Contributor → Project catalog: edits (evidence: `README.md`)
- Repository discovery → GitHub API: searches (evidence: `scripts/discover.mjs`)
- Repository discovery → Project catalog: reads and adds (evidence: `scripts/discover.mjs`)
- Repository discovery → Excluded repositories: checks (evidence: `scripts/discover.mjs`)
- Repository discovery → Category classifier: classifies with (evidence: `scripts/discover.mjs`)
- Star refresh → GitHub API: fetches repository data (evidence: `scripts/refresh.mjs`)
- Star refresh → Project catalog: updates (evidence: `scripts/refresh.mjs`)
- Catalog validation → Project catalog: validates (evidence: `scripts/validate.mjs`)
- Directory renderer → Project catalog: reads (evidence: `scripts/build.mjs`)
- Directory renderer → HTML template: reads (evidence: `scripts/build.mjs`)
- Directory renderer → Generated README: renders (evidence: `scripts/build.mjs`)
- Directory renderer → Searchable directory: generates directory for (evidence: `scripts/build.mjs`)
