# ademczuk/menuvision architecture

> Architecture diagram of the GitHub repository ademczuk/menuvision, 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/ademczuk/menuvision
- Repository: https://github.com/ademczuk/menuvision

## Overview

MenuVision is an AI-assistant skill specification for building restaurant photo menus, rather than a conventional application runtime. A user supplies a menu source; an assistant follows the skill’s documented pipeline to extract structured menu data, generate food images, and produce an HTML menu. The README also documents portable output and optional GitHub Pages publishing. Relationships below are based on README statements only; the skill file itself was not available as a source excerpt.

Main entry points: [`.claude/skills/menu-builder.md`](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md) (HTML menu builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_spec["Build specification"]
  node_skill["Menu builder skill<br/>[menu-builder.md]"]
end

subgraph group_pipeline["Menu generation"]
  node_extract["Menu extraction<br/>[menu-builder.md]"]
  node_contract["Structured menu data<br/>[menu-builder.md]"]
  node_imagegen["Food image generation<br/>[menu-builder.md]"]
  node_images["Food images<br/>[menu-builder.md]"]
  node_html["HTML menu builder<br/>[menu-builder.md]"]
end

subgraph group_delivery["Menu delivery"]
  node_menu["Photo menu<br/>[menu-builder.md]"]
  node_portable["Portable HTML<br/>[menu-builder.md]"]
end

node_user(("Menu requester"))
node_assistant["AI assistant"]
node_source["Menu source"]
node_gemini["Gemini API"]
node_pages["GitHub Pages gallery"]

node_user -->|"requests menu"| node_assistant
node_user -->|"provides source"| node_source
node_assistant -->|"follows specification"| node_skill
node_assistant -->|"runs extraction"| node_extract
node_source -->|"supplies URL, PDF, or photo"| node_extract
node_extract -->|"uses Gemini Vision"| node_gemini
node_extract -->|"produces structured JSON"| node_contract
node_assistant -->|"generates images"| node_imagegen
node_imagegen -->|"uses Gemini Image"| node_gemini
node_imagegen -->|"produces food images"| node_images
node_assistant -->|"builds menu"| node_html
node_html -->|"uses menu data"| node_contract
node_html -->|"embeds images"| node_images
node_html -->|"produces HTML menu"| node_menu
node_menu -->|"exports portable file"| node_portable
node_assistant -.->|"optionally publishes"| node_pages
node_pages -->|"hosts menu pages"| node_menu

click node_skill "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_extract "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_contract "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_imagegen "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_images "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_html "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_menu "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"
click node_portable "https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md"

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_skill toneBlue
class node_extract,node_contract,node_imagegen,node_images,node_html toneAmber
class node_menu,node_portable,node_user,node_gemini toneMint
class node_assistant,node_source,node_pages toneIndigo
```

## Components

### Build specification

- [Menu builder skill](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`

### Menu generation

- [Menu extraction](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`
- [Structured menu data](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`
- [Food image generation](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`
- [Food images](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`
- [HTML menu builder](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`

### Menu delivery

- [Photo menu](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`
- [Portable HTML](https://github.com/ademczuk/menuvision/blob/master/.claude/skills/menu-builder.md): `.claude/skills/menu-builder.md`

### Other components

- **Menu requester**
- **AI assistant**
- **Menu source**
- **Gemini API**
- **GitHub Pages gallery**

## Connections

- Menu requester → AI assistant: requests menu (evidence: `README.md`)
- Menu requester → Menu source: provides source (evidence: `README.md`)
- AI assistant → Menu builder skill: follows specification (evidence: `README.md`)
- AI assistant → Menu extraction: runs extraction (evidence: `README.md`)
- Menu source → Menu extraction: supplies URL, PDF, or photo (evidence: `README.md`)
- Menu extraction → Gemini API: uses Gemini Vision (evidence: `README.md`)
- Menu extraction → Structured menu data: produces structured JSON (evidence: `README.md`)
- AI assistant → Food image generation: generates images (evidence: `README.md`)
- Food image generation → Gemini API: uses Gemini Image (evidence: `README.md`)
- Food image generation → Food images: produces food images (evidence: `README.md`)
- AI assistant → HTML menu builder: builds menu (evidence: `README.md`)
- HTML menu builder → Structured menu data: uses menu data (evidence: `README.md`)
- HTML menu builder → Food images: embeds images (evidence: `README.md`)
- HTML menu builder → Photo menu: produces HTML menu (evidence: `README.md`)
- Photo menu → Portable HTML: exports portable file (evidence: `README.md`)
- AI assistant → GitHub Pages gallery: optionally publishes (evidence: `README.md`)
- GitHub Pages gallery → Photo menu: hosts menu pages (evidence: `README.md`)
