# vishesh233/mosaiq-qr-studio architecture

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

- Interactive diagram: https://gitdiagram.com/vishesh233/mosaiq-qr-studio
- Repository: https://github.com/vishesh233/mosaiq-qr-studio

## Overview

Mosaiq QR Studio is an offline Windows desktop app for creating, styling, scanning, exporting, and bulk-generating QR codes. The main workflow runs from the app shell to a feature page: Generate builds a typed payload, renders and tests a code, then exports or records it; Scan obtains an image from a supported source, decodes and interprets it, then records the result. Bulk Create validates CSV rows and produces files. History and Settings provide local persistence and appearance controls. Edges rely on the README and SOURCE INDEX references; unsampled modules are represented only where documented or indexed.

Main entry points: [`ui/app.py`](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/app.py) (Desktop app), [`ui/pages/scan_page.py`](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/scan_page.py) (Scan page), [`ui/pages/generate_page.py`](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/generate_page.py) (Generate page), [`ui/pages/settings_page.py`](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/settings_page.py) (Settings page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["Desktop app<br/>[app.py]"]
end

subgraph group_creation["Create and export"]
  node_generate["Generate page<br/>[generate_page.py]"]
  node_payloads["QR payloads<br/>[qr_payloads.py]"]
  node_generator["QR generator<br/>[qr_generator.py]"]
  node_renderer["QR renderer<br/>[qr_render.py]"]
  node_export["QR export<br/>[qr_export.py]"]
  node_bulk["Bulk Create page<br/>[bulk_page.py]"]
  node_csv["CSV processing<br/>[bulk_csv.py]"]
  node_bulk_runner["Bulk runner<br/>[bulk_runner.py]"]
end

subgraph group_scanning["Scan and decode"]
  node_scan["Scan page<br/>[scan_page.py]"]
  node_scanner["QR scanner<br/>[qr_scanner.py]"]
  node_camera["Camera scanner<br/>[camera_scanner.py]"]
  node_screen["Screen capture<br/>[screen_capture.py]"]
end

subgraph group_localdata["Local data"]
  node_history_page["History page<br/>[history_page.py]"]
  node_history_store[("History store<br/>[history_store.py]")]
  node_settings[("Settings store<br/>[settings_store.py]")]
end

subgraph group_appearance["Appearance"]
  node_settings_page["Settings page<br/>[settings_page.py]"]
  node_theme["Theme manager<br/>[theme_manager.py]"]
  node_transition["Theme transition"]
end

node_user(("User"))
node_image_source(("Image or camera"))

node_user -->|"uses"| node_app
node_app -->|"shows page"| node_generate
node_app -->|"shows page"| node_scan
node_app -->|"shows page"| node_history_page
node_app -->|"shows page"| node_bulk
node_app -->|"shows page"| node_settings_page
node_generate -->|"builds payload"| node_payloads
node_generate -->|"generates code"| node_generator
node_generator -->|"renders matrix"| node_renderer
node_generate -->|"previews code"| node_renderer
node_generate -->|"exports code"| node_export
node_generate -->|"records code"| node_history_store
node_bulk -->|"loads rows"| node_csv
node_csv -->|"builds payload"| node_payloads
node_bulk -->|"starts job"| node_bulk_runner
node_bulk_runner -->|"generates codes"| node_generator
node_bulk_runner -->|"writes files"| node_export
node_image_source -->|"provides image"| node_scan
node_scan -->|"decodes image"| node_scanner
node_scan -->|"starts camera"| node_camera
node_camera -->|"decodes frames"| node_scanner
node_scan -->|"captures region"| node_screen
node_scan -->|"parses result"| node_payloads
node_scan -->|"records scan"| node_history_store
node_history_page -->|"loads entries"| node_history_store
node_history_page -->|"regenerates code"| node_generator
node_settings_page -->|"saves preferences"| node_settings
node_settings_page -->|"configures history"| node_history_store
node_settings_page -->|"previews theme"| node_theme
node_settings_page -->|"animates change"| node_transition
node_theme -->|"loads and saves"| node_settings
node_app -->|"applies transition"| node_transition

click node_app "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/app.py"
click node_generate "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/generate_page.py"
click node_payloads "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_payloads.py"
click node_generator "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_generator.py"
click node_renderer "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_render.py"
click node_export "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_export.py"
click node_bulk "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/bulk_page.py"
click node_csv "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/bulk_csv.py"
click node_bulk_runner "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/bulk_runner.py"
click node_scan "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/scan_page.py"
click node_scanner "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_scanner.py"
click node_camera "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/camera_scanner.py"
click node_screen "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/screen_capture.py"
click node_history_page "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/history_page.py"
click node_history_store "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/history_store.py"
click node_settings_page "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/settings_page.py"
click node_settings "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/settings_store.py"
click node_theme "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/theme_manager.py"
click node_transition "https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/theme_transition.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_user toneBlue
class node_generate,node_payloads,node_generator,node_renderer,node_export,node_bulk,node_csv,node_bulk_runner toneAmber
class node_scan,node_scanner,node_camera,node_screen toneMint
class node_history_page,node_history_store,node_settings toneRose
class node_settings_page,node_theme,node_transition,node_image_source toneIndigo
```

## Components

### App shell

- [Desktop app](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/app.py): `ui/app.py`

### Create and export

- [Generate page](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/generate_page.py): `ui/pages/generate_page.py`
- [QR payloads](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_payloads.py): `utils/qr_payloads.py`
- [QR generator](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_generator.py): `utils/qr_generator.py`
- [QR renderer](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_render.py): `utils/qr_render.py`
- [QR export](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_export.py): `utils/qr_export.py`
- [Bulk Create page](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/bulk_page.py): `ui/pages/bulk_page.py`
- [CSV processing](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/bulk_csv.py): `utils/bulk_csv.py`
- [Bulk runner](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/bulk_runner.py): `utils/bulk_runner.py`

### Scan and decode

- [Scan page](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/scan_page.py): `ui/pages/scan_page.py`
- [QR scanner](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/qr_scanner.py): `utils/qr_scanner.py`
- [Camera scanner](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/camera_scanner.py): `utils/camera_scanner.py`
- [Screen capture](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/screen_capture.py): `utils/screen_capture.py`

### Local data

- [History page](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/history_page.py): `ui/pages/history_page.py`
- [History store](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/history_store.py): `utils/history_store.py`
- [Settings store](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/settings_store.py): `utils/settings_store.py`

### Appearance

- [Settings page](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/ui/pages/settings_page.py): `ui/pages/settings_page.py`
- [Theme manager](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/theme_manager.py): `utils/theme_manager.py`
- [Theme transition](https://github.com/vishesh233/mosaiq-qr-studio/blob/main/utils/theme_transition.py): `utils/theme_transition.py`

### Other components

- **User**
- **Image or camera**

## Connections

- User → Desktop app: uses
- Desktop app → Generate page: shows page (evidence: `ui/app.py`)
- Desktop app → Scan page: shows page (evidence: `ui/app.py`)
- Desktop app → History page: shows page (evidence: `ui/app.py`)
- Desktop app → Bulk Create page: shows page (evidence: `ui/app.py`)
- Desktop app → Settings page: shows page (evidence: `ui/app.py`)
- Generate page → QR payloads: builds payload (evidence: `ui/pages/generate_page.py`)
- Generate page → QR generator: generates code (evidence: `ui/pages/generate_page.py`)
- QR generator → QR renderer: renders matrix (evidence: `utils/qr_generator.py`)
- Generate page → QR renderer: previews code (evidence: `ui/pages/generate_page.py`)
- Generate page → QR export: exports code (evidence: `ui/pages/generate_page.py`)
- Generate page → History store: records code (evidence: `ui/pages/generate_page.py`)
- Bulk Create page → CSV processing: loads rows (evidence: `ui/pages/bulk_page.py`)
- CSV processing → QR payloads: builds payload (evidence: `utils/bulk_csv.py`)
- Bulk Create page → Bulk runner: starts job (evidence: `ui/pages/bulk_page.py`)
- Bulk runner → QR generator: generates codes
- Bulk runner → QR export: writes files
- Image or camera → Scan page: provides image
- Scan page → QR scanner: decodes image (evidence: `ui/pages/scan_page.py`)
- Scan page → Camera scanner: starts camera (evidence: `ui/pages/scan_page.py`)
- Camera scanner → QR scanner: decodes frames (evidence: `utils/camera_scanner.py`)
- Scan page → Screen capture: captures region (evidence: `ui/pages/scan_page.py`)
- Scan page → QR payloads: parses result (evidence: `ui/pages/scan_page.py`)
- Scan page → History store: records scan (evidence: `ui/pages/scan_page.py`)
- History page → History store: loads entries (evidence: `ui/pages/history_page.py`)
- History page → QR generator: regenerates code (evidence: `ui/pages/history_page.py`)
- Settings page → Settings store: saves preferences (evidence: `ui/pages/settings_page.py`)
- Settings page → History store: configures history (evidence: `ui/pages/settings_page.py`)
- Settings page → Theme manager: previews theme (evidence: `ui/pages/settings_page.py`)
- Settings page → Theme transition: animates change (evidence: `ui/pages/settings_page.py`)
- Theme manager → Settings store: loads and saves (evidence: `utils/theme_manager.py`)
- Desktop app → Theme transition: applies transition (evidence: `ui/app.py`)
