# subeesh-ct/studio-qr-code-wishes architecture

> Architecture diagram of the GitHub repository subeesh-ct/studio-qr-code-wishes, 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/subeesh-ct/studio-qr-code-wishes
- Repository: https://github.com/subeesh-ct/studio-qr-code-wishes

## Overview

CT Wishlink Generator is a Windows desktop app for composing personalized wishes and producing shareable links with QR codes. The main workflow is user input, occasion/theme selection, optional image or audio handling, link generation, then QR output. The README documents ImgBB uploads, audio URL support, live QR generation, and first-run configuration. The excerpts show configuration persistence, image compression, setup UI, and output UI; most runtime wiring is unsampled, so inferred connections are dashed and have no evidence path.

Main entry points: [`app.py`](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py) (Desktop Workflow), [`themes.html`](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/themes.html) (Theme Catalog), [`index.html`](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/index.html) (Wish Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop App"]
  node_app["Desktop Workflow<br/>[app.py]"]
  node_setup["First-Run Setup<br/>[app.py]"]
  node_config[("Saved Configuration<br/>[app.py]")]
end

subgraph group_content["Wish Content"]
  node_form["Wish Form<br/>[app.py]"]
  node_themes["Theme Catalog<br/>[themes.html]"]
  node_wish_page["Wish Page<br/>[index.html]"]
end

subgraph group_media["Media Services"]
  node_image_processing["Image Compression<br/>[app.py]"]
  node_image_upload["ImgBB Upload<br/>[app.py]"]
  node_audio["Audio URL Support<br/>[app.py]"]
  node_imgbb{{"ImgBB Service"}}
end

subgraph group_delivery["Link Delivery"]
  node_link["Generated Wish Link<br/>[app.py]"]
  node_output["Link and QR Output<br/>[app.py]"]
  node_qr["Downloadable QR Code<br/>[app.py]"]
end

node_user(("App User"))

node_user -->|"uses"| node_app
node_app -.->|"opens setup"| node_setup
node_setup -->|"saves settings"| node_config
node_app -.->|"shows form"| node_form
node_form -.->|"selects theme"| node_themes
node_form -.->|"processes image"| node_image_processing
node_image_processing -.->|"prepares upload"| node_image_upload
node_image_upload -.->|"uploads image"| node_imgbb
node_form -.->|"supports audio"| node_audio
node_app -.->|"generates wish"| node_wish_page
node_app -.->|"creates link"| node_link
node_app -.->|"shows result"| node_output
node_output -.->|"generates QR"| node_qr

click node_app "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_setup "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_config "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_form "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_themes "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/themes.html"
click node_wish_page "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/index.html"
click node_image_processing "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_image_upload "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_audio "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_link "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_output "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"
click node_qr "https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py"

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_setup,node_config,node_user toneBlue
class node_form,node_themes,node_wish_page toneAmber
class node_image_processing,node_image_upload,node_audio,node_imgbb toneMint
class node_link,node_output,node_qr toneRose
```

## Components

### Desktop App

- [Desktop Workflow](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [First-Run Setup](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [Saved Configuration](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`

### Wish Content

- [Wish Form](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [Theme Catalog](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/themes.html): `themes.html`
- [Wish Page](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/index.html): `index.html`

### Media Services

- [Image Compression](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [ImgBB Upload](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [Audio URL Support](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- **ImgBB Service**

### Link Delivery

- [Generated Wish Link](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [Link and QR Output](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`
- [Downloadable QR Code](https://github.com/subeesh-ct/studio-qr-code-wishes/blob/main/app.py): `app.py`

### Other components

- **App User**

## Connections

- App User → Desktop Workflow: uses (evidence: `README.md`)
- Desktop Workflow → First-Run Setup: opens setup (evidence: `app.py`)
- First-Run Setup → Saved Configuration: saves settings (evidence: `app.py`)
- Desktop Workflow → Wish Form: shows form (evidence: `app.py`)
- Wish Form → Theme Catalog: selects theme
- Wish Form → Image Compression: processes image (evidence: `app.py`)
- Image Compression → ImgBB Upload: prepares upload (evidence: `app.py`)
- ImgBB Upload → ImgBB Service: uploads image
- Wish Form → Audio URL Support: supports audio (evidence: `README.md`)
- Desktop Workflow → Wish Page: generates wish
- Desktop Workflow → Generated Wish Link: creates link (evidence: `README.md`)
- Desktop Workflow → Link and QR Output: shows result (evidence: `app.py`)
- Link and QR Output → Downloadable QR Code: generates QR (evidence: `README.md`)
