# xianyu110/awesome-gpt-6-astra architecture

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

- Interactive diagram: https://gitdiagram.com/xianyu110/awesome-gpt-6-astra
- Repository: https://github.com/xianyu110/awesome-gpt-6-astra

## Overview

Awesome GPT-6 Astra is a community showcase and catalogue of GPT-6 Astra projects, with playable demos and a curator tool for maintaining structured cases. The visitor workflow loads the catalogue, falls back to a static snapshot if needed, and presents project details, previews, and playable embeds. The catalogue is parsed from the repository README and refreshed by the website service; preview requests resolve project media separately. The tree also preserves merged source collections. Source excerpts show key website and curator calls, but not every runtime branch.

Main entry points: [`sources/martin/website/src/App.jsx`](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/src/App.jsx) (Showcase Interface), [`sources/martin/website/server/previews.js`](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/previews.js) (Preview Resolver), [`sources/martin/website/server/catalog.js`](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/catalog.js) (Catalogue Service), [`sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs`](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs) (Curator Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalogue Content"]
  node_readme["Showcase Catalogue<br/>[README.md]"]
  node_fallback[("Static Catalogue")]
end

subgraph group_site["Showcase Website"]
  node_catalog_service["Catalogue Service<br/>[catalog.js]"]
  node_catalog_api["Catalogue API<br/>[catalog.js]"]
  node_preview_api["Preview API<br/>[preview.js]"]
  node_preview_service["Preview Resolver<br/>[previews.js]"]
  node_preview_version["Preview Versioning<br/>[preview-version.js]"]
  node_catalog_client["Catalogue Client<br/>[catalog-client.js]"]
  node_app["Showcase Interface<br/>[App.jsx]"]
  node_entry["Browser Entry<br/>[main.jsx]"]
end

subgraph group_curation["Case Curation"]
  node_curator["Curator Commands<br/>[curator.mjs]"]
  node_record_tools["Record Operations<br/>[records.mjs]"]
end

subgraph group_archive["Merged Sources"]
  node_source_archive["Imported Collections"]
end

node_visitor(("Visitor"))
node_external_demos(("Project Demo Sites"))
node_contributor(("Contributor"))

node_visitor -->|"opens site"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"fetches through"| node_catalog_client
node_app -->|"requests catalogue"| node_catalog_api
node_app -->|"loads fallback"| node_fallback
node_catalog_api -->|"calls"| node_catalog_service
node_catalog_service -->|"parses catalogue"| node_readme
node_preview_api -->|"configures handler"| node_preview_service
node_preview_api -->|"provides loader"| node_catalog_service
node_preview_service -->|"loads catalogue"| node_catalog_service
node_preview_service -->|"checks version"| node_preview_version
node_app -->|"builds preview path"| node_preview_version
node_app -.->|"requests previews"| node_preview_api
node_preview_service -.->|"fetches media"| node_external_demos
node_app -->|"embeds demo"| node_external_demos
node_contributor -.->|"runs commands"| node_curator
node_curator -->|"validates and edits"| node_record_tools
node_curator -.->|"maintains cases"| node_source_archive
node_readme -->|"summarizes sources"| node_source_archive

click node_readme "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/README.md"
click node_fallback "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/public/data/catalog-fallback.json"
click node_catalog_service "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/catalog.js"
click node_catalog_api "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/api/catalog.js"
click node_preview_api "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/api/preview.js"
click node_preview_service "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/previews.js"
click node_preview_version "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/shared/preview-version.js"
click node_catalog_client "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/shared/catalog-client.js"
click node_app "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/src/App.jsx"
click node_entry "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/src/main.jsx"
click node_curator "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs"
click node_record_tools "https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/zender/skills/awesome-gpt6-curator/scripts/records.mjs"
click node_source_archive "https://github.com/xianyu110/awesome-gpt-6-astra/tree/main/sources"

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_fallback toneBlue
class node_catalog_service,node_catalog_api,node_preview_api,node_preview_service,node_preview_version,node_catalog_client,node_app,node_entry toneAmber
class node_curator,node_record_tools toneMint
class node_source_archive toneRose
class node_visitor,node_external_demos,node_contributor toneIndigo
```

## Components

### Catalogue Content

- [Showcase Catalogue](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/README.md): `README.md`
- [Static Catalogue](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/public/data/catalog-fallback.json): `sources/martin/website/public/data/catalog-fallback.json`

### Showcase Website

- [Catalogue Service](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/catalog.js): `sources/martin/website/server/catalog.js`
- [Catalogue API](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/api/catalog.js): `sources/martin/website/api/catalog.js`
- [Preview API](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/api/preview.js): `sources/martin/website/api/preview.js`
- [Preview Resolver](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/server/previews.js): `sources/martin/website/server/previews.js`
- [Preview Versioning](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/shared/preview-version.js): `sources/martin/website/shared/preview-version.js`
- [Catalogue Client](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/shared/catalog-client.js): `sources/martin/website/shared/catalog-client.js`
- [Showcase Interface](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/src/App.jsx): `sources/martin/website/src/App.jsx`
- [Browser Entry](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/martin/website/src/main.jsx): `sources/martin/website/src/main.jsx`

### Case Curation

- [Curator Commands](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs): `sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs`
- [Record Operations](https://github.com/xianyu110/awesome-gpt-6-astra/blob/main/sources/zender/skills/awesome-gpt6-curator/scripts/records.mjs): `sources/zender/skills/awesome-gpt6-curator/scripts/records.mjs`

### Merged Sources

- [Imported Collections](https://github.com/xianyu110/awesome-gpt-6-astra/tree/main/sources): `sources`

### Other components

- **Visitor**
- **Project Demo Sites**
- **Contributor**

## Connections

- Visitor → Browser Entry: opens site (evidence: `sources/martin/website/src/main.jsx`)
- Browser Entry → Showcase Interface: renders (evidence: `sources/martin/website/src/main.jsx`)
- Showcase Interface → Catalogue Client: fetches through (evidence: `sources/martin/website/src/App.jsx`)
- Showcase Interface → Catalogue API: requests catalogue (evidence: `sources/martin/website/src/App.jsx`)
- Showcase Interface → Static Catalogue: loads fallback (evidence: `sources/martin/website/src/App.jsx`)
- Catalogue API → Catalogue Service: calls (evidence: `sources/martin/website/api/catalog.js`)
- Catalogue Service → Showcase Catalogue: parses catalogue (evidence: `sources/martin/website/server/catalog.js`)
- Preview API → Preview Resolver: configures handler (evidence: `sources/martin/website/api/preview.js`)
- Preview API → Catalogue Service: provides loader (evidence: `sources/martin/website/api/preview.js`)
- Preview Resolver → Catalogue Service: loads catalogue (evidence: `sources/martin/website/server/previews.js`)
- Preview Resolver → Preview Versioning: checks version (evidence: `sources/martin/website/server/previews.js`)
- Showcase Interface → Preview Versioning: builds preview path (evidence: `sources/martin/website/src/App.jsx`)
- Showcase Interface → Preview API: requests previews
- Preview Resolver → Project Demo Sites: fetches media
- Showcase Interface → Project Demo Sites: embeds demo (evidence: `sources/martin/website/src/App.jsx`)
- Contributor → Curator Commands: runs commands
- Curator Commands → Record Operations: validates and edits (evidence: `sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs`)
- Curator Commands → Imported Collections: maintains cases (evidence: `sources/zender/skills/awesome-gpt6-curator/scripts/curator.mjs`)
- Showcase Catalogue → Imported Collections: summarizes sources (evidence: `README.md`)
