# yuzu-hub/appscreen architecture

> Architecture diagram of the GitHub repository yuzu-hub/appscreen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yuzu-hub/appscreen
- Repository: https://github.com/yuzu-hub/appscreen

## Overview

App Store Screenshot Generator is a browser-based editor for assembling localized App Store marketing images. The main workflow is to upload screenshots, choose an output size, customize the background and device presentation, add text, and export one or many results. The product also supports projects, browser-based autosave, AI-assisted translation and title generation, and 3D previews. The README documents capabilities and the IndexedDB/Canvas/Three.js stack; sampled code confirms the AI integrations and native menu shell, but the main app source is only partially excerpted.

Main entry points: [`app.js`](https://github.com/yuzu-hub/appscreen/blob/main/app.js) (Editing Workspace), [`magical-titles.js`](https://github.com/yuzu-hub/appscreen/blob/main/magical-titles.js) (Magical Titles), [`src-tauri/src/lib.rs`](https://github.com/yuzu-hub/appscreen/blob/main/src-tauri/src/lib.rs) (Desktop Menu Shell), [`lucide-icons.js`](https://github.com/yuzu-hub/appscreen/blob/main/lucide-icons.js) (Emoji and Icons)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Screenshot Editing"]
  node_editor["Editing Workspace<br/>[app.js]"]
  node_screenshots["Screenshot Inputs<br/>[app.js]"]
  node_backgrounds["Background Styling<br/>[app.js]"]
  node_device["Device Styling<br/>[app.js]"]
  node_text["Text Overlays<br/>[app.js]"]
  node_elements["Emoji and Icons<br/>[lucide-icons.js]"]
end

subgraph group_language["Language and AI"]
  node_localization["Localized Screenshots<br/>[language-utils.js]"]
  node_translation["AI Translation<br/>[app.js]"]
  node_provider_config["AI Provider Config<br/>[llm.js]"]
  node_title_generation["Magical Titles<br/>[magical-titles.js]"]
end

subgraph group_rendering["Preview and Export"]
  node_canvas["2D Canvas Preview<br/>[app.js]"]
  node_three_d["3D Device Preview<br/>[three-renderer.js]"]
  node_export["Screenshot Export<br/>[app.js]"]
  node_zip["Batch ZIP<br/>[app.js]"]
end

subgraph group_platform["Projects and Platform"]
  node_projects["Project Management<br/>[app.js]"]
  node_storage[("Browser Storage")]
  node_native_shell["Desktop Menu Shell<br/>[lib.rs]"]
end

node_user(("Editor"))
node_ai_services["AI Providers"]
node_google_fonts["Google Fonts"]
node_image_result["Exported Images"]

node_user -->|"edits in"| node_editor
node_editor -->|"uploads"| node_screenshots
node_editor -->|"customizes"| node_backgrounds
node_editor -->|"positions"| node_device
node_editor -->|"adds"| node_text
node_editor -->|"exports"| node_export
node_editor -->|"manages languages"| node_localization
node_editor -->|"manages projects"| node_projects
node_editor -->|"previews in 2D"| node_canvas
node_editor -->|"previews in 3D"| node_three_d
node_editor -.->|"offers elements"| node_elements
node_editor -->|"requests translation"| node_translation
node_translation -.->|"uses provider settings"| node_provider_config
node_translation -->|"calls provider"| node_ai_services
node_editor -.->|"generates titles"| node_title_generation
node_title_generation -->|"sends image prompts"| node_ai_services
node_editor -->|"loads fonts"| node_google_fonts
node_projects -->|"autosaves to"| node_storage
node_export -->|"produces"| node_image_result
node_export -->|"batches as"| node_zip
node_native_shell -->|"forwards menu actions"| node_editor

click node_editor "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_screenshots "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_backgrounds "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_device "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_text "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_elements "https://github.com/yuzu-hub/appscreen/blob/main/lucide-icons.js"
click node_localization "https://github.com/yuzu-hub/appscreen/blob/main/language-utils.js"
click node_translation "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_provider_config "https://github.com/yuzu-hub/appscreen/blob/main/llm.js"
click node_title_generation "https://github.com/yuzu-hub/appscreen/blob/main/magical-titles.js"
click node_canvas "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_three_d "https://github.com/yuzu-hub/appscreen/blob/main/three-renderer.js"
click node_export "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_zip "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_projects "https://github.com/yuzu-hub/appscreen/blob/main/app.js"
click node_native_shell "https://github.com/yuzu-hub/appscreen/blob/main/src-tauri/src/lib.rs"

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_editor,node_screenshots,node_backgrounds,node_device,node_text,node_elements toneBlue
class node_localization,node_translation,node_provider_config,node_title_generation toneAmber
class node_canvas,node_three_d,node_export,node_zip toneMint
class node_projects,node_storage,node_native_shell toneRose
class node_user,node_ai_services,node_google_fonts,node_image_result toneIndigo
```

## Components

### Screenshot Editing

- [Editing Workspace](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Screenshot Inputs](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Background Styling](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Device Styling](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Text Overlays](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Emoji and Icons](https://github.com/yuzu-hub/appscreen/blob/main/lucide-icons.js): `lucide-icons.js`

### Language and AI

- [Localized Screenshots](https://github.com/yuzu-hub/appscreen/blob/main/language-utils.js): `language-utils.js`
- [AI Translation](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [AI Provider Config](https://github.com/yuzu-hub/appscreen/blob/main/llm.js): `llm.js`
- [Magical Titles](https://github.com/yuzu-hub/appscreen/blob/main/magical-titles.js): `magical-titles.js`

### Preview and Export

- [2D Canvas Preview](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [3D Device Preview](https://github.com/yuzu-hub/appscreen/blob/main/three-renderer.js): `three-renderer.js`
- [Screenshot Export](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- [Batch ZIP](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`

### Projects and Platform

- [Project Management](https://github.com/yuzu-hub/appscreen/blob/main/app.js): `app.js`
- **Browser Storage**
- [Desktop Menu Shell](https://github.com/yuzu-hub/appscreen/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`

### Other components

- **Editor**
- **AI Providers**
- **Google Fonts**
- **Exported Images**

## Connections

- Editor → Editing Workspace: edits in (evidence: `README.md`)
- Editing Workspace → Screenshot Inputs: uploads (evidence: `README.md`)
- Editing Workspace → Background Styling: customizes (evidence: `README.md`)
- Editing Workspace → Device Styling: positions (evidence: `README.md`)
- Editing Workspace → Text Overlays: adds (evidence: `README.md`)
- Editing Workspace → Screenshot Export: exports (evidence: `README.md`)
- Editing Workspace → Localized Screenshots: manages languages (evidence: `README.md`)
- Editing Workspace → Project Management: manages projects (evidence: `README.md`)
- Editing Workspace → 2D Canvas Preview: previews in 2D (evidence: `README.md`)
- Editing Workspace → 3D Device Preview: previews in 3D (evidence: `README.md`)
- Editing Workspace → Emoji and Icons: offers elements
- Editing Workspace → AI Translation: requests translation (evidence: `README.md`)
- AI Translation → AI Provider Config: uses provider settings
- AI Translation → AI Providers: calls provider (evidence: `README.md`)
- Editing Workspace → Magical Titles: generates titles
- Magical Titles → AI Providers: sends image prompts (evidence: `magical-titles.js`)
- Editing Workspace → Google Fonts: loads fonts (evidence: `README.md`)
- Project Management → Browser Storage: autosaves to (evidence: `README.md`)
- Screenshot Export → Exported Images: produces (evidence: `README.md`)
- Screenshot Export → Batch ZIP: batches as (evidence: `README.md`)
- Desktop Menu Shell → Editing Workspace: forwards menu actions (evidence: `src-tauri/src/lib.rs`)
