# opennookorg/screenshot-studio architecture

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

- Interactive diagram: https://gitdiagram.com/opennookorg/screenshot-studio
- Repository: https://github.com/opennookorg/screenshot-studio

## Overview

Screenshot Studio is a browser-based screenshot, mockup, and social-graphics editor, with separate image utilities and specialized creation workflows. The main user flow is to open the editor, compose on the canvas using backgrounds, frames, and overlays, then export an image or animation. The README also documents batch image tools, background removal, code-to-image, and app-store assets. Connections are limited to README statements and relationships visible in the supplied excerpts or SOURCE INDEX; some unsampled subsystem internals are therefore represented without speculative call edges.

Main entry points: [`lib/store/index.ts`](https://github.com/opennookorg/screenshot-studio/blob/main/lib/store/index.ts) (Composition state), [`components/canvas/ClientCanvas.tsx`](https://github.com/opennookorg/screenshot-studio/blob/main/components/canvas/ClientCanvas.tsx) (Canvas renderer), [`app/api/screenshot/route.ts`](https://github.com/opennookorg/screenshot-studio/blob/main/app/api/screenshot/route.ts) (Screenshot API), [`app/[locale]/editor/page.tsx`](https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/editor/page.tsx) (Editor entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Screenshot editor"]
  node_editor_route["Editor entry<br/>[page.tsx]"]
  node_editor_ui["Editor workspace<br/>[EditorContent.tsx]"]
  node_editor_state["Composition state<br/>[index.ts]"]
  node_canvas["Canvas renderer<br/>[ClientCanvas.tsx]"]
  node_drafts[("Draft persistence<br/>[draft-storage.ts]")]
end

subgraph group_creation["Specialized creators"]
  node_store_route["Store screenshots<br/>[page.tsx]"]
  node_store_workspace["Store workspace"]
  node_store_projects[("Store projects<br/>[storage.ts]")]
  node_code_route["Code to image<br/>[page.tsx]"]
  node_code_editor["Code image editor"]
end

subgraph group_image_tools["Image utilities"]
  node_tool_route["Image tools<br/>[page.tsx]"]
  node_tool_workspace["Tool workspace<br/>[ToolWorkspace.tsx]"]
  node_tool_queue["Batch tool queue<br/>[useToolQueue.ts]"]
  node_image_ops["Image operations<br/>[ops.ts]"]
  node_background_removal["Background removal<br/>[client.ts]"]
  node_removal_worker["Segmentation worker<br/>[engine.worker.ts]"]
end

subgraph group_render_export["Rendering and export"]
  node_export_service["Export service<br/>[export-service.ts]"]
  node_export_workers["Export worker service"]
end

subgraph group_services["Supporting services"]
  node_screenshot_api["Screenshot API<br/>[route.ts]"]
  node_screenshot_cache[("Screenshot cache")]
  node_screenshot_provider["Screenshot provider"]
end

node_user(("Creator"))

node_user -->|"opens editor"| node_editor_route
node_editor_route -.->|"presents workspace"| node_editor_ui
node_user -->|"creates store assets"| node_store_route
node_user -->|"creates code graphic"| node_code_route
node_user -->|"chooses image tool"| node_tool_route
node_editor_ui -.->|"edits composition"| node_editor_state
node_editor_state -->|"renders state"| node_canvas
node_editor_state -->|"persists draft"| node_drafts
node_canvas -->|"reads state"| node_editor_state
node_store_route -.->|"loads workspace"| node_store_workspace
node_store_workspace -.->|"stores projects"| node_store_projects
node_code_route -.->|"opens editor"| node_code_editor
node_tool_route -.->|"offers tools"| node_tool_workspace
node_tool_workspace -.->|"manages batch input"| node_tool_queue
node_tool_queue -->|"runs operations"| node_image_ops
node_background_removal -.->|"dispatches requests"| node_removal_worker
node_canvas -.->|"captures composition"| node_export_service
node_export_service -->|"delegates processing"| node_export_workers
node_screenshot_api -->|"reads and updates"| node_screenshot_cache
node_screenshot_api -.->|"requests capture"| node_screenshot_provider

click node_editor_route "https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/editor/page.tsx"
click node_editor_ui "https://github.com/opennookorg/screenshot-studio/blob/main/components/editor/EditorContent.tsx"
click node_editor_state "https://github.com/opennookorg/screenshot-studio/blob/main/lib/store/index.ts"
click node_canvas "https://github.com/opennookorg/screenshot-studio/blob/main/components/canvas/ClientCanvas.tsx"
click node_drafts "https://github.com/opennookorg/screenshot-studio/blob/main/lib/draft-storage.ts"
click node_store_route "https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/store-screenshots/page.tsx"
click node_store_workspace "https://github.com/opennookorg/screenshot-studio/blob/main/components/store-screenshots/StoreScreenshotWorkspace.tsx"
click node_store_projects "https://github.com/opennookorg/screenshot-studio/blob/main/lib/store-screenshots/storage.ts"
click node_code_route "https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/code/page.tsx"
click node_code_editor "https://github.com/opennookorg/screenshot-studio/blob/main/components/code-image/CodeImageEditor.tsx"
click node_tool_route "https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/tools/page.tsx"
click node_tool_workspace "https://github.com/opennookorg/screenshot-studio/blob/main/components/tools/ToolWorkspace.tsx"
click node_tool_queue "https://github.com/opennookorg/screenshot-studio/blob/main/components/tools/useToolQueue.ts"
click node_image_ops "https://github.com/opennookorg/screenshot-studio/blob/main/lib/image-tools/ops.ts"
click node_background_removal "https://github.com/opennookorg/screenshot-studio/blob/main/lib/background-removal/client.ts"
click node_removal_worker "https://github.com/opennookorg/screenshot-studio/blob/main/lib/background-removal/engine.worker.ts"
click node_export_service "https://github.com/opennookorg/screenshot-studio/blob/main/lib/export/export-service.ts"
click node_export_workers "https://github.com/opennookorg/screenshot-studio/blob/main/lib/workers/export-worker-service.ts"
click node_screenshot_api "https://github.com/opennookorg/screenshot-studio/blob/main/app/api/screenshot/route.ts"
click node_screenshot_cache "https://github.com/opennookorg/screenshot-studio/blob/main/lib/screenshot-cache.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_editor_route,node_editor_ui,node_editor_state,node_canvas,node_drafts toneBlue
class node_store_route,node_store_workspace,node_store_projects,node_code_route,node_code_editor toneAmber
class node_tool_route,node_tool_workspace,node_tool_queue,node_image_ops,node_background_removal,node_removal_worker toneMint
class node_export_service,node_export_workers toneRose
class node_screenshot_api,node_screenshot_cache,node_screenshot_provider,node_user toneIndigo
```

## Components

### Screenshot editor

- [Editor entry](https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/editor/page.tsx): `app/[locale]/editor/page.tsx`
- [Editor workspace](https://github.com/opennookorg/screenshot-studio/blob/main/components/editor/EditorContent.tsx): `components/editor/EditorContent.tsx`
- [Composition state](https://github.com/opennookorg/screenshot-studio/blob/main/lib/store/index.ts): `lib/store/index.ts`
- [Canvas renderer](https://github.com/opennookorg/screenshot-studio/blob/main/components/canvas/ClientCanvas.tsx): `components/canvas/ClientCanvas.tsx`
- [Draft persistence](https://github.com/opennookorg/screenshot-studio/blob/main/lib/draft-storage.ts): `lib/draft-storage.ts`

### Specialized creators

- [Store screenshots](https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/store-screenshots/page.tsx): `app/[locale]/store-screenshots/page.tsx`
- [Store workspace](https://github.com/opennookorg/screenshot-studio/blob/main/components/store-screenshots/StoreScreenshotWorkspace.tsx): `components/store-screenshots/StoreScreenshotWorkspace.tsx`
- [Store projects](https://github.com/opennookorg/screenshot-studio/blob/main/lib/store-screenshots/storage.ts): `lib/store-screenshots/storage.ts`
- [Code to image](https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/code/page.tsx): `app/[locale]/code/page.tsx`
- [Code image editor](https://github.com/opennookorg/screenshot-studio/blob/main/components/code-image/CodeImageEditor.tsx): `components/code-image/CodeImageEditor.tsx`

### Image utilities

- [Image tools](https://github.com/opennookorg/screenshot-studio/blob/main/app/%5Blocale%5D/tools/page.tsx): `app/[locale]/tools/page.tsx`
- [Tool workspace](https://github.com/opennookorg/screenshot-studio/blob/main/components/tools/ToolWorkspace.tsx): `components/tools/ToolWorkspace.tsx`
- [Batch tool queue](https://github.com/opennookorg/screenshot-studio/blob/main/components/tools/useToolQueue.ts): `components/tools/useToolQueue.ts`
- [Image operations](https://github.com/opennookorg/screenshot-studio/blob/main/lib/image-tools/ops.ts): `lib/image-tools/ops.ts`
- [Background removal](https://github.com/opennookorg/screenshot-studio/blob/main/lib/background-removal/client.ts): `lib/background-removal/client.ts`
- [Segmentation worker](https://github.com/opennookorg/screenshot-studio/blob/main/lib/background-removal/engine.worker.ts): `lib/background-removal/engine.worker.ts`

### Rendering and export

- [Export service](https://github.com/opennookorg/screenshot-studio/blob/main/lib/export/export-service.ts): `lib/export/export-service.ts`
- [Export worker service](https://github.com/opennookorg/screenshot-studio/blob/main/lib/workers/export-worker-service.ts): `lib/workers/export-worker-service.ts`

### Supporting services

- [Screenshot API](https://github.com/opennookorg/screenshot-studio/blob/main/app/api/screenshot/route.ts): `app/api/screenshot/route.ts`
- [Screenshot cache](https://github.com/opennookorg/screenshot-studio/blob/main/lib/screenshot-cache.ts): `lib/screenshot-cache.ts`
- **Screenshot provider**

### Other components

- **Creator**

## Connections

- Creator → Editor entry: opens editor (evidence: `README.md`)
- Editor entry → Editor workspace: presents workspace
- Creator → Store screenshots: creates store assets (evidence: `README.md`)
- Creator → Code to image: creates code graphic (evidence: `README.md`)
- Creator → Image tools: chooses image tool (evidence: `README.md`)
- Editor workspace → Composition state: edits composition
- Composition state → Canvas renderer: renders state (evidence: `components/canvas/ClientCanvas.tsx`)
- Composition state → Draft persistence: persists draft (evidence: `hooks/useAutosaveDraft.ts`)
- Canvas renderer → Composition state: reads state (evidence: `components/canvas/ClientCanvas.tsx`)
- Store screenshots → Store workspace: loads workspace
- Store workspace → Store projects: stores projects
- Code to image → Code image editor: opens editor
- Image tools → Tool workspace: offers tools
- Tool workspace → Batch tool queue: manages batch input
- Batch tool queue → Image operations: runs operations (evidence: `components/tools/useToolQueue.ts`)
- Background removal → Segmentation worker: dispatches requests
- Canvas renderer → Export service: captures composition
- Export service → Export worker service: delegates processing (evidence: `lib/export/export-service.ts`)
- Screenshot API → Screenshot cache: reads and updates (evidence: `app/api/screenshot/route.ts`)
- Screenshot API → Screenshot provider: requests capture
