# zho-zho-zho/zho-nano-banana-creation architecture

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

- Interactive diagram: https://gitdiagram.com/zho-zho-zho/zho-nano-banana-creation
- Repository: https://github.com/zho-zho-zho/zho-nano-banana-creation

## Overview

This repository is not an application codebase; it is a documentation-and-curation repo centered on a single `README.md`. Architecturally, it functions as a public catalog of prompt recipes and example outputs for “Nano-Banana” image/video generation workflows.

Main subsystems

1. Content catalog
- The core of the repo is a numbered collection of 46 “original玩法” entries.
- Each entry follows the same pattern:
  - an image or short media example,
  - a prompt or prompt sequence,
  - a link back to the author’s original post on X.
- The catalog is organized by use case rather than by implementation:
  - character/style transformation,
  - identity preservation,
  - object replacement and composition,
  - product visualization,
  - architecture/model rendering,
  - fashion/editorial generation,
  - toy/package mockups,
  - lighting/reference transfer,
  - pose/expression transfer,
  - multi-panel process generation,
  - video-oriented workflows.

2. Deployment / companion-product section
- A separate section presents three external tools as the “three-piece set”:
  - Nano Bananary / 香蕉超市
  - BananaPod / 香蕉铺子
  - BananaFlow / 香蕉工厂
- These are not implemented in this repository; they are outbound links to other repositories/products.
- Their purpose in the architecture is important: this repo is a showcase and entry point, while the actual interactive experiences live elsewhere.

3. Change log / maintenance metadata
- The changelog records repository evolution by date:
  - project creation,
  - addition of the standalone open-source app,
  - completion of the 46-item prompt collection,
  - addition of the three deployment options.
- This is the only lifecycle/operational metadata present.

4. Attribution and credit boundary
- The README explicitly credits Gemini 2.5 Flash Image as the base model.
- Some prompts are attributed to other creators or X posts.
- The repo also contains a strong attribution note and a request to cite sources, indicating that provenance is part of the repo’s “governance” layer.

External services and tools that materially affect the architecture

- Gemini 2.5 Flash Image is the central model referenced for image generation/editing.
- Veo 3 is referenced for video generation in several workflows.
- X/Twitter is used as the canonical publishing and sharing channel for the examples.
- GitHub serves only as the hosting layer for the documentation and media embeds.

Data flow

1. Source idea and prompt crafting
- The author designs a workflow idea, often starting from an image transformation concept.

2. Example capture
- Before/after images or short clips are produced using external generative models.

3. Documentation
- The prompt, example media, and explanatory notes are embedded into the README.
- Related X posts are linked for provenance and discussion.

4. Distribution
- Readers consume the README directly on GitHub.
- For hands-on use, they are directed to one of the three companion projects rather than this repo.

Important architectural boundaries

- No application runtime boundary exists here.
- No backend, database, API server, job queue, or frontend app is defined in this repository.
- All generation execution happens outside the repo, in model services and companion applications.
- This repo’s responsibility is limited to curation, presentation, and linkage.
- The repo is effectively a static knowledge base / prompt playbook, not an executable system.

How to draw the architecture accurately

- Put this repository in the center as a documentation layer.
- Show one inbound flow from the author’s prompt experiments and generated media into the README.
- Show one outbound flow from the README to:
  - Gemini 2.5 Flash Image,
  - Veo 3,
  - the three companion repos/apps,
  - X/Twitter posts.
- Do not depict internal services inside this repo; there are none beyond static markdown content.

Main entry points: [`README.md`](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md) (README)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph "Documentation"
  readme["README<br/>catalog doc<br/>[README.md]"]
  recipes["Prompt recipes<br/>curated prompts<br/>[README.md]"]
  examples["Example media<br/>embedded samples<br/>[README.md]"]
  usecases["Use cases<br/>taxonomy<br/>[README.md]"]
  charstyle["Character style<br/>workflow cluster<br/>[README.md]"]
  identity["Identity preserve<br/>workflow cluster<br/>[README.md]"]
  product["Product visuals<br/>workflow cluster<br/>[README.md]"]
  architecture["Architecture<br/>workflow cluster<br/>[README.md]"]
  fashion["Fashion<br/>workflow cluster<br/>[README.md]"]
  pose["Pose transfer<br/>workflow cluster<br/>[README.md]"]
  video["Video flows<br/>workflow cluster<br/>[README.md]"]
  changelog["Changelog<br/>lifecycle log<br/>[README.md]"]
end

subgraph "External services"
  gemini(("Gemini 2.5<br/>image model"))
  veo(("Veo 3<br/>video model"))
  xposts(("X posts<br/>publishing source"))
  github(("GitHub<br/>hosting layer"))
  sourceideas(("Source ideas<br/>author experiments"))
end

subgraph "Companion tools"
  bananary["Nano Bananary<br/>companion app"]
  bananapod["BananaPod<br/>companion app"]
  bananaflow["BananaFlow<br/>companion app"]
end

subgraph "Governance"
  attribution["Attribution<br/>provenance policy<br/>[README.md]"]
end

sourceideas -->|"generate"| examples
sourceideas -->|"craft"| recipes
examples -->|"embed"| readme
recipes -->|"publish"| readme
readme -->|"organize"| usecases
usecases -->|"includes"| charstyle
usecases -->|"includes"| identity
usecases -->|"includes"| product
usecases -->|"includes"| architecture
usecases -->|"includes"| fashion
usecases -->|"includes"| pose
usecases -->|"includes"| video
readme -->|"references"| gemini
readme -->|"references"| veo
readme -->|"links out"| xposts
readme -->|"hosts on"| github
readme -->|"points to"| bananary
readme -->|"points to"| bananapod
readme -->|"points to"| bananaflow
readme -->|"records"| changelog
readme -->|"governs"| attribution

click readme "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click recipes "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click examples "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click usecases "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click charstyle "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click identity "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click product "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click architecture "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click fashion "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click pose "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click video "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click changelog "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.md"
click attribution "https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/main/README.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 readme,recipes,examples,usecases,charstyle,identity,product,architecture,fashion,pose,video,changelog toneBlue
class gemini,veo,xposts,github,sourceideas toneAmber
class bananary,bananapod,bananaflow toneMint
class attribution toneRose
```

## Components

### Documentation

Static README-based catalog and metadata

- [README](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): catalog doc · Single-file public catalog of prompt recipes and example outputs · `README.md`
- [Prompt recipes](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): curated prompts · Numbered collection of Nano-Banana workflow prompts · `README.md`
- [Example media](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): embedded samples · Before/after images and short clips shown with each recipe · `README.md`
- [Use cases](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): taxonomy · Catalog organized by transformation, product, fashion, pose, and video workflows · `README.md`
- [Character style](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Style transfer and character transformation examples · `README.md`
- [Identity preserve](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Identity-preserving edits and controlled transformations · `README.md`
- [Product visuals](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Object replacement, packaging, and product mockups · `README.md`
- [Architecture](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Building, model, and environment rendering examples · `README.md`
- [Fashion](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Editorial, clothing, and styling generation examples · `README.md`
- [Pose transfer](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Pose, expression, and multi-panel process workflows · `README.md`
- [Video flows](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): workflow cluster · Short video-oriented generation workflows · `README.md`
- [Changelog](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): lifecycle log · Date-based history of project milestones and additions · `README.md`

### External services

Model services and publishing platforms used by the catalog

- **Gemini 2.5**: image model · Primary image generation and editing model referenced by the repo
- **Veo 3**: video model · Video generation model referenced in video workflows
- **X posts**: publishing source · Canonical source posts linked for each example and prompt
- **GitHub**: hosting layer · Static hosting and rendering layer for the README catalog
- **Source ideas**: author experiments · Upstream prompt experiments and generated media created by the author

### Companion tools

Outbound companion products referenced as the hands-on path

- **Nano Bananary**: companion app · External companion tool in the three-piece set
- **BananaPod**: companion app · External companion tool in the three-piece set
- **BananaFlow**: companion app · External companion tool in the three-piece set

### Governance

Attribution and provenance boundary

- [Attribution](https://github.com/zho-zho-zho/zho-nano-banana-creation/blob/HEAD/README.md): provenance policy · Credits, source links, and citation request · `README.md`

## Connections

- Source ideas → Example media: generate · Author experiments produce the media and prompt material
- Source ideas → Prompt recipes: craft · Upstream ideas are distilled into reusable prompt recipes
- Example media → README: embed · Captured media is embedded into the documentation catalog
- Prompt recipes → README: publish · Prompt instructions are collected in the README
- README → Use cases: organize · The catalog is arranged by workflow family
- Use cases → Character style: includes · One major family of workflows
- Use cases → Identity preserve: includes · One major family of workflows
- Use cases → Product visuals: includes · One major family of workflows
- Use cases → Architecture: includes · One major family of workflows
- Use cases → Fashion: includes · One major family of workflows
- Use cases → Pose transfer: includes · One major family of workflows
- Use cases → Video flows: includes · One major family of workflows
- README → Gemini 2.5: references · Primary model used for image generation and editing
- README → Veo 3: references · Video workflows point to this external model
- README → X posts: links out · Each recipe is tied back to an original X post
- README → GitHub: hosts on · The repository is delivered as a static README on GitHub
- README → Nano Bananary: points to · One of the external companion tools for hands-on use
- README → BananaPod: points to · One of the external companion tools for hands-on use
- README → BananaFlow: points to · One of the external companion tools for hands-on use
- README → Changelog: records · README includes the repository evolution log
- README → Attribution: governs · README includes source credit and citation guidance
