# orkunisitmak/banana-studio architecture

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

- Interactive diagram: https://gitdiagram.com/orkunisitmak/banana-studio
- Repository: https://github.com/orkunisitmak/banana-studio

## Overview

Banana Studio is a creative workspace for image generation and editing, prompt planning, YouTube thumbnail creation, and video. Users configure a project, add prompts and references, submit generation or editing work, then track jobs and organize results in a gallery. The graph preserves major documented capabilities while emphasizing relationships visible in excerpts or the README; unsampled provider and gallery internals are represented at their exact enclosing directories, without inferred call chains.

Main entry points: [`src/App.tsx`](https://github.com/orkunisitmak/banana-studio/blob/main/src/App.tsx) (Workspace UI), [`src/services/geminiService.ts`](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/geminiService.ts) (Enhance & brainstorm), [`src/services/storageService.ts`](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/storageService.ts) (Gallery persistence), [`api/_lib/imageJobRunner.ts`](https://github.com/orkunisitmak/banana-studio/blob/main/api/_lib/imageJobRunner.ts) (Image job runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace &amp; identity"]
  node_app["Workspace UI<br/>[App.tsx]"]
  node_auth["Authentication<br/>[authService.ts]"]
  node_runtimeconfig["Workspace config<br/>[runtimeConfig.ts]"]
end

subgraph group_creative["Creative planning"]
  node_people["People &amp; references"]
  node_prompting["Prompt preparation<br/>[imagePrompting.ts]"]
  node_textmodels["Text model selection<br/>[textModels.ts]"]
  node_textservice["Enhance &amp; brainstorm<br/>[geminiService.ts]"]
  node_textapi["OpenRouter text API"]
  node_youtube["YouTube planning"]
end

subgraph group_media["Image &amp; video generation"]
  node_imageconfig["Image options<br/>[openaiImage.ts]"]
  node_imagegeneration["Image generation"]
  node_edit["Area editing"]
  node_video["Video workflows<br/>[h3Max.ts]"]
  node_providers["Provider routes<br/>[providers.ts]"]
end

subgraph group_gallery["Gallery &amp; sharing"]
  node_storage[("Gallery persistence<br/>[storageService.ts]")]
  node_galleryui["Gallery &amp; history<br/>[Gallery.tsx]"]
  node_sharing["Folder sharing"]
end

subgraph group_runtime["Execution &amp; storage"]
  node_apiimage["Image API"]
  node_jobqueue["Durable image jobs<br/>[imageJobQueue.ts]"]
  node_jobrunner["Image job runner<br/>[imageJobRunner.ts]"]
  node_worker["Image worker"]
  node_desktop["Desktop server<br/>[main.mjs]"]
  node_localstore[("Local workspace store<br/>[store.mjs]")]
  node_mediaaccess["Media access<br/>[mediaAccess.ts]"]
end

node_user(("Creator"))

node_user -->|"uses"| node_app
node_app -->|"authenticates via"| node_auth
node_app -->|"reads config"| node_runtimeconfig
node_app -->|"configures references"| node_people
node_app -->|"requests Enhance"| node_textservice
node_textservice -->|"prepares prompts"| node_prompting
node_textservice -->|"resolves model"| node_textmodels
node_textservice -->|"routes text request"| node_textapi
node_app -->|"plans thumbnails"| node_youtube
node_app -->|"sets image options"| node_imageconfig
node_app -->|"submits image"| node_imagegeneration
node_app -->|"submits edits"| node_edit
node_app -->|"creates video tasks"| node_video
node_app -->|"selects provider"| node_providers
node_imagegeneration -.->|"sends request"| node_apiimage
node_apiimage -.->|"enqueues jobs"| node_jobqueue
node_worker -->|"reads jobs"| node_jobqueue
node_worker -->|"runs jobs"| node_jobrunner
node_jobrunner -.->|"persists media"| node_storage
node_app -->|"saves results"| node_storage
node_galleryui -.->|"loads gallery"| node_storage
node_app -->|"organizes results"| node_galleryui
node_app -->|"shares folders"| node_sharing
node_desktop -->|"opens workspace"| node_localstore
node_desktop -->|"dispatches jobs"| node_jobrunner
node_storage -->|"resolves media"| node_mediaaccess

click node_app "https://github.com/orkunisitmak/banana-studio/blob/main/src/App.tsx"
click node_auth "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/authService.ts"
click node_runtimeconfig "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/config/runtimeConfig.ts"
click node_people "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/references/personReferences.ts"
click node_prompting "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/images/imagePrompting.ts"
click node_textmodels "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/prompts/textModels.ts"
click node_textservice "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/geminiService.ts"
click node_textapi "https://github.com/orkunisitmak/banana-studio/blob/main/api/openrouter-text-generate.ts"
click node_youtube "https://github.com/orkunisitmak/banana-studio/tree/main/src/lib/youtube"
click node_imageconfig "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/images/openaiImage.ts"
click node_imagegeneration "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/openaiImageService.ts"
click node_edit "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/imageEditService.ts"
click node_video "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/video/h3Max.ts"
click node_providers "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/providers.ts"
click node_apiimage "https://github.com/orkunisitmak/banana-studio/blob/main/api/openai-image-generate.ts"
click node_jobqueue "https://github.com/orkunisitmak/banana-studio/blob/main/api/_lib/imageJobQueue.ts"
click node_jobrunner "https://github.com/orkunisitmak/banana-studio/blob/main/api/_lib/imageJobRunner.ts"
click node_worker "https://github.com/orkunisitmak/banana-studio/blob/main/api/image-job-worker.ts"
click node_desktop "https://github.com/orkunisitmak/banana-studio/blob/main/desktop/server/main.mjs"
click node_storage "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/storageService.ts"
click node_galleryui "https://github.com/orkunisitmak/banana-studio/blob/main/src/components/Gallery.tsx"
click node_sharing "https://github.com/orkunisitmak/banana-studio/blob/main/src/services/folderShareService.ts"
click node_localstore "https://github.com/orkunisitmak/banana-studio/blob/main/desktop/server/store.mjs"
click node_mediaaccess "https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/references/mediaAccess.ts"

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_app,node_auth,node_runtimeconfig toneBlue
class node_people,node_prompting,node_textmodels,node_textservice,node_textapi,node_youtube toneAmber
class node_imageconfig,node_imagegeneration,node_edit,node_video,node_providers toneMint
class node_storage,node_galleryui,node_sharing toneRose
class node_apiimage,node_jobqueue,node_jobrunner,node_worker,node_desktop,node_localstore,node_mediaaccess,node_user toneIndigo
```

## Components

### Workspace & identity

- [Workspace UI](https://github.com/orkunisitmak/banana-studio/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Workspace config](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/config/runtimeConfig.ts): `src/lib/config/runtimeConfig.ts`

### Creative planning

- [People & references](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/references/personReferences.ts): `src/lib/references/personReferences.ts`
- [Prompt preparation](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/images/imagePrompting.ts): `src/lib/images/imagePrompting.ts`
- [Text model selection](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/prompts/textModels.ts): `src/lib/prompts/textModels.ts`
- [Enhance & brainstorm](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/geminiService.ts): `src/services/geminiService.ts`
- [OpenRouter text API](https://github.com/orkunisitmak/banana-studio/blob/main/api/openrouter-text-generate.ts): `api/openrouter-text-generate.ts`
- [YouTube planning](https://github.com/orkunisitmak/banana-studio/tree/main/src/lib/youtube): `src/lib/youtube`

### Image & video generation

- [Image options](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/images/openaiImage.ts): `src/lib/images/openaiImage.ts`
- [Image generation](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/openaiImageService.ts): `src/services/openaiImageService.ts`
- [Area editing](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/imageEditService.ts): `src/services/imageEditService.ts`
- [Video workflows](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/video/h3Max.ts): `src/lib/video/h3Max.ts`
- [Provider routes](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/providers.ts): `src/lib/providers.ts`

### Gallery & sharing

- [Gallery persistence](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/storageService.ts): `src/services/storageService.ts`
- [Gallery & history](https://github.com/orkunisitmak/banana-studio/blob/main/src/components/Gallery.tsx): `src/components/Gallery.tsx`
- [Folder sharing](https://github.com/orkunisitmak/banana-studio/blob/main/src/services/folderShareService.ts): `src/services/folderShareService.ts`

### Execution & storage

- [Image API](https://github.com/orkunisitmak/banana-studio/blob/main/api/openai-image-generate.ts): `api/openai-image-generate.ts`
- [Durable image jobs](https://github.com/orkunisitmak/banana-studio/blob/main/api/_lib/imageJobQueue.ts): `api/_lib/imageJobQueue.ts`
- [Image job runner](https://github.com/orkunisitmak/banana-studio/blob/main/api/_lib/imageJobRunner.ts): `api/_lib/imageJobRunner.ts`
- [Image worker](https://github.com/orkunisitmak/banana-studio/blob/main/api/image-job-worker.ts): `api/image-job-worker.ts`
- [Desktop server](https://github.com/orkunisitmak/banana-studio/blob/main/desktop/server/main.mjs): `desktop/server/main.mjs`
- [Local workspace store](https://github.com/orkunisitmak/banana-studio/blob/main/desktop/server/store.mjs): `desktop/server/store.mjs`
- [Media access](https://github.com/orkunisitmak/banana-studio/blob/main/src/lib/references/mediaAccess.ts): `src/lib/references/mediaAccess.ts`

### Other components

- **Creator**

## Connections

- Creator → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Authentication: authenticates via (evidence: `src/App.tsx`)
- Workspace UI → Workspace config: reads config (evidence: `src/App.tsx`)
- Workspace UI → People & references: configures references (evidence: `src/App.tsx`)
- Workspace UI → Enhance & brainstorm: requests Enhance (evidence: `src/services/geminiService.ts`)
- Enhance & brainstorm → Prompt preparation: prepares prompts (evidence: `src/services/geminiService.ts`)
- Enhance & brainstorm → Text model selection: resolves model (evidence: `src/services/geminiService.ts`)
- Enhance & brainstorm → OpenRouter text API: routes text request (evidence: `src/services/geminiService.ts`)
- Workspace UI → YouTube planning: plans thumbnails (evidence: `README.md`)
- Workspace UI → Image options: sets image options (evidence: `src/App.tsx`)
- Workspace UI → Image generation: submits image (evidence: `src/App.tsx`)
- Workspace UI → Area editing: submits edits (evidence: `README.md`)
- Workspace UI → Video workflows: creates video tasks (evidence: `src/App.tsx`)
- Workspace UI → Provider routes: selects provider (evidence: `README.md`)
- Image generation → Image API: sends request
- Image API → Durable image jobs: enqueues jobs
- Image worker → Durable image jobs: reads jobs (evidence: `api/image-job-worker.ts`)
- Image worker → Image job runner: runs jobs (evidence: `api/image-job-worker.ts`)
- Image job runner → Gallery persistence: persists media
- Workspace UI → Gallery persistence: saves results (evidence: `src/App.tsx`)
- Gallery & history → Gallery persistence: loads gallery
- Workspace UI → Gallery & history: organizes results (evidence: `README.md`)
- Workspace UI → Folder sharing: shares folders (evidence: `README.md`)
- Desktop server → Local workspace store: opens workspace (evidence: `desktop/server/main.mjs`)
- Desktop server → Image job runner: dispatches jobs (evidence: `desktop/server/main.mjs`)
- Gallery persistence → Media access: resolves media (evidence: `src/services/storageService.ts`)
