# legeling/awesome-codex-pet architecture

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

- Interactive diagram: https://gitdiagram.com/legeling/awesome-codex-pet
- Repository: https://github.com/legeling/awesome-codex-pet

## Overview

Awesome Codex Pet is a community gallery and catalog for animated Codex pets. Visitors browse pets and collections, inspect rankings and creator pages, install a selected pet, or submit a character request with references. The repository also includes catalog and preview generation plus a Worker for community actions and request handling. The graph emphasizes documented routes and visible imports/calls; some unsampled page and Worker internals are represented only at their known source paths, and uncertain connections are omitted.

Main entry points: [`web/app/page.tsx`](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/page.tsx) (Home route), [`web/app/request/page.tsx`](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/request/page.tsx) (Request pages), [`web/components/manual-request-form.tsx`](https://github.com/legeling/awesome-codex-pet/blob/main/web/components/manual-request-form.tsx) (Request form), [`web/app/install/page.tsx`](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/install/page.tsx) (Install guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gallery["Gallery and discovery"]
  node_home["Home route<br/>[page.tsx]"]
  node_gallery_ui["Pet gallery<br/>[pet-gallery.tsx]"]
  node_pet_pages["Pet detail pages<br/>[page.tsx]"]
  node_pet_detail["Pet detail view"]
  node_pet_catalog["Pet catalog<br/>[pets.ts]"]
  node_collections["Collections<br/>[page.tsx]"]
  node_collection_catalog["Collection catalog"]
end

subgraph group_community["Community features"]
  node_rankings["Rankings<br/>[page.tsx]"]
  node_leaderboards["Leaderboard data<br/>[leaderboards.ts]"]
  node_requests_page["Request pages<br/>[page.tsx]"]
  node_request_ui["Request form"]
  node_request_catalog["Request listings<br/>[request-catalog.ts]"]
end

subgraph group_install["Install and catalog"]
  node_install_page["Install guide<br/>[page.tsx]"]
  node_install_content["Install guidance"]
  node_cli["Remote installer"]
  node_install_command["Install command helper"]
  node_preview_generator["Preview generation"]
  node_site_preparation["Site catalog preparation<br/>[prepare-site.mjs]"]
  node_readme_generator["Catalog README generation"]
end

subgraph group_service["Community service"]
  node_worker["API Worker<br/>[index.js]"]
  node_d1[("D1 metrics store")]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_home
node_visitor -->|"opens guide"| node_install_page
node_visitor -->|"submits request"| node_requests_page
node_home -->|"loads pets"| node_pet_catalog
node_home -->|"loads collections"| node_collection_catalog
node_home -->|"loads community data"| node_leaderboards
node_home -->|"loads requests"| node_request_catalog
node_home -->|"renders gallery"| node_gallery_ui
node_pet_pages -->|"renders detail"| node_pet_detail
node_collections -.->|"loads collection"| node_collection_catalog
node_rankings -->|"builds rankings"| node_leaderboards
node_requests_page -.->|"renders form"| node_request_ui
node_request_ui -->|"calls request API"| node_worker
node_worker -.->|"stores metrics"| node_d1
node_install_page -->|"renders guidance"| node_install_content
node_visitor -->|"runs installer"| node_cli
node_readme_generator -->|"uses command helper"| node_install_command
node_site_preparation -->|"uses command helper"| node_install_command

click node_home "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/page.tsx"
click node_gallery_ui "https://github.com/legeling/awesome-codex-pet/blob/main/web/components/pet-gallery.tsx"
click node_pet_pages "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/pets/%5Bslug%5D/page.tsx"
click node_pet_detail "https://github.com/legeling/awesome-codex-pet/blob/main/web/components/pet-detail-content.tsx"
click node_pet_catalog "https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/pets.ts"
click node_collections "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/collections/%5Bslug%5D/page.tsx"
click node_collection_catalog "https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/collection-catalog.ts"
click node_rankings "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/rankings/page.tsx"
click node_leaderboards "https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/leaderboards.ts"
click node_requests_page "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/request/page.tsx"
click node_request_ui "https://github.com/legeling/awesome-codex-pet/blob/main/web/components/manual-request-form.tsx"
click node_request_catalog "https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/request-catalog.ts"
click node_worker "https://github.com/legeling/awesome-codex-pet/blob/main/worker/src/index.js"
click node_install_page "https://github.com/legeling/awesome-codex-pet/blob/main/web/app/install/page.tsx"
click node_install_content "https://github.com/legeling/awesome-codex-pet/blob/main/web/components/install-page-content.tsx"
click node_cli "https://github.com/legeling/awesome-codex-pet/blob/main/scripts/install-pet-remote.mjs"
click node_install_command "https://github.com/legeling/awesome-codex-pet/blob/main/scripts/install-command.mjs"
click node_preview_generator "https://github.com/legeling/awesome-codex-pet/blob/main/scripts/generate-pet-previews.py"
click node_site_preparation "https://github.com/legeling/awesome-codex-pet/blob/main/web/scripts/prepare-site.mjs"
click node_readme_generator "https://github.com/legeling/awesome-codex-pet/blob/main/scripts/generate-readmes.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_home,node_gallery_ui,node_pet_pages,node_pet_detail,node_pet_catalog,node_collections,node_collection_catalog toneBlue
class node_rankings,node_leaderboards,node_requests_page,node_request_ui,node_request_catalog toneAmber
class node_install_page,node_install_content,node_cli,node_install_command,node_preview_generator,node_site_preparation,node_readme_generator toneMint
class node_worker,node_d1 toneRose
class node_visitor toneIndigo
```

## Components

### Gallery and discovery

- [Home route](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/page.tsx): `web/app/page.tsx`
- [Pet gallery](https://github.com/legeling/awesome-codex-pet/blob/main/web/components/pet-gallery.tsx): `web/components/pet-gallery.tsx`
- [Pet detail pages](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/pets/%5Bslug%5D/page.tsx): `web/app/pets/[slug]/page.tsx`
- [Pet detail view](https://github.com/legeling/awesome-codex-pet/blob/main/web/components/pet-detail-content.tsx): `web/components/pet-detail-content.tsx`
- [Pet catalog](https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/pets.ts): `web/lib/pets.ts`
- [Collections](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/collections/%5Bslug%5D/page.tsx): `web/app/collections/[slug]/page.tsx`
- [Collection catalog](https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/collection-catalog.ts): `web/lib/collection-catalog.ts`

### Community features

- [Rankings](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/rankings/page.tsx): `web/app/rankings/page.tsx`
- [Leaderboard data](https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/leaderboards.ts): `web/lib/leaderboards.ts`
- [Request pages](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/request/page.tsx): `web/app/request/page.tsx`
- [Request form](https://github.com/legeling/awesome-codex-pet/blob/main/web/components/manual-request-form.tsx): `web/components/manual-request-form.tsx`
- [Request listings](https://github.com/legeling/awesome-codex-pet/blob/main/web/lib/request-catalog.ts): `web/lib/request-catalog.ts`

### Install and catalog

- [Install guide](https://github.com/legeling/awesome-codex-pet/blob/main/web/app/install/page.tsx): `web/app/install/page.tsx`
- [Install guidance](https://github.com/legeling/awesome-codex-pet/blob/main/web/components/install-page-content.tsx): `web/components/install-page-content.tsx`
- [Remote installer](https://github.com/legeling/awesome-codex-pet/blob/main/scripts/install-pet-remote.mjs): `scripts/install-pet-remote.mjs`
- [Install command helper](https://github.com/legeling/awesome-codex-pet/blob/main/scripts/install-command.mjs): `scripts/install-command.mjs`
- [Preview generation](https://github.com/legeling/awesome-codex-pet/blob/main/scripts/generate-pet-previews.py): `scripts/generate-pet-previews.py`
- [Site catalog preparation](https://github.com/legeling/awesome-codex-pet/blob/main/web/scripts/prepare-site.mjs): `web/scripts/prepare-site.mjs`
- [Catalog README generation](https://github.com/legeling/awesome-codex-pet/blob/main/scripts/generate-readmes.mjs): `scripts/generate-readmes.mjs`

### Community service

- [API Worker](https://github.com/legeling/awesome-codex-pet/blob/main/worker/src/index.js): `worker/src/index.js`
- **D1 metrics store**

### Other components

- **Visitor**

## Connections

- Visitor → Home route: browses (evidence: `README.md`)
- Visitor → Install guide: opens guide (evidence: `README.md`)
- Visitor → Request pages: submits request (evidence: `README.md`)
- Home route → Pet catalog: loads pets (evidence: `web/app/page.tsx`)
- Home route → Collection catalog: loads collections (evidence: `web/app/page.tsx`)
- Home route → Leaderboard data: loads community data (evidence: `web/app/page.tsx`)
- Home route → Request listings: loads requests (evidence: `web/app/page.tsx`)
- Home route → Pet gallery: renders gallery (evidence: `web/app/page.tsx`)
- Pet detail pages → Pet detail view: renders detail (evidence: `web/app/pets/[slug]/page.tsx`)
- Collections → Collection catalog: loads collection
- Rankings → Leaderboard data: builds rankings (evidence: `web/app/rankings/page.tsx`)
- Request pages → Request form: renders form
- Request form → API Worker: calls request API (evidence: `web/components/manual-request-form.tsx`)
- API Worker → D1 metrics store: stores metrics
- Install guide → Install guidance: renders guidance (evidence: `web/app/install/page.tsx`)
- Visitor → Remote installer: runs installer (evidence: `README.md`)
- Catalog README generation → Install command helper: uses command helper (evidence: `scripts/generate-readmes.mjs`)
- Site catalog preparation → Install command helper: uses command helper (evidence: `web/scripts/prepare-site.mjs`)
