# pavol-humeny/figurio architecture

> Architecture diagram of the GitHub repository pavol-humeny/figurio, 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/pavol-humeny/figurio
- Repository: https://github.com/pavol-humeny/figurio

## Overview

Figurio is a browser-based image editor for preparing screenshots, diagrams, and illustrations for technical and academic documents. Users open or drop image/PDF files, edit them with image and annotation tools, then export the result; workspace tabs and undo/redo support continued editing. Image processing is documented as local, with vector PDF handling where possible. The graph also includes the documented usage-statistics capability. Edges reflect the supplied excerpts, index references, or README; unsampled feature wiring is intentionally left unspecified.

Main entry points: [`src/stores/imageStore.js`](https://github.com/pavol-humeny/figurio/blob/main/src/stores/imageStore.js) (Image state), [`src/stores/workspaceStore.js`](https://github.com/pavol-humeny/figurio/blob/main/src/stores/workspaceStore.js) (Workspace tabs), [`src/composables/editor/useImagePipeline.js`](https://github.com/pavol-humeny/figurio/blob/main/src/composables/editor/useImagePipeline.js) (Image pipeline), [`src/composables/common/useApi.js`](https://github.com/pavol-humeny/figurio/blob/main/src/composables/common/useApi.js) (Usage statistics API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_entry["App shell<br/>[App.vue]"]
  node_routing["Page routing<br/>[index.js]"]
  node_editor_view["Editor page<br/>[EditorView.vue]"]
end

subgraph group_editing["Editing Workflow"]
  node_file_drop["File drop UI"]
  node_file_ingest["Import files"]
  node_export["Export files"]
  node_edit_tools["Image tools"]
  node_frame_tool["Frame tool<br/>[useFrameTool.js]"]
  node_pipeline["Image pipeline"]
  node_operations["Image operations"]
  node_tool_ui["Tool panels"]
end

subgraph group_state["Editor State"]
  node_image_state["Image state<br/>[imageStore.js]"]
  node_history["Undo redo<br/>[historyStore.js]"]
  node_workspace["Workspace tabs<br/>[workspaceStore.js]"]
  node_viewport["Viewport state<br/>[viewportStore.js]"]
  node_ui_state["UI preferences<br/>[uiStore.js]"]
end

subgraph group_insights["Usage Insights"]
  node_stats_pages["Statistics pages<br/>[StatisticsView.vue]"]
  node_stats_api["Usage statistics API<br/>[useApi.js]"]
  node_stats_service["Statistics service"]
end

node_user(("Editor user"))

node_user -->|"uses"| node_app_entry
node_app_entry -->|"loads routes"| node_routing
node_routing -->|"routes to"| node_editor_view
node_user -->|"drops files"| node_file_drop
node_editor_view -->|"includes"| node_file_drop
node_file_drop -->|"delegates import"| node_file_ingest
node_user -->|"edits image"| node_edit_tools
node_tool_ui -->|"configures tools"| node_edit_tools
node_frame_tool -->|"applies operations"| node_pipeline
node_pipeline -->|"dispatches operations"| node_operations
node_pipeline -->|"updates image"| node_image_state
node_image_state -->|"uses frame logic"| node_frame_tool
node_image_state -->|"uses history"| node_history
node_workspace -->|"snapshots state"| node_image_state
node_workspace -->|"snapshots history"| node_history
node_workspace -->|"snapshots viewport"| node_viewport
node_user -->|"exports result"| node_export
node_stats_pages -->|"requests statistics"| node_stats_api
node_stats_api -->|"reads user ID"| node_ui_state
node_stats_api -.->|"fetches statistics"| node_stats_service

click node_app_entry "https://github.com/pavol-humeny/figurio/blob/main/src/App.vue"
click node_routing "https://github.com/pavol-humeny/figurio/blob/main/src/router/index.js"
click node_editor_view "https://github.com/pavol-humeny/figurio/blob/main/src/views/EditorView.vue"
click node_file_drop "https://github.com/pavol-humeny/figurio/blob/main/src/components/editor/DragAndDropArea.vue"
click node_file_ingest "https://github.com/pavol-humeny/figurio/blob/main/src/services/importFileService.js"
click node_export "https://github.com/pavol-humeny/figurio/blob/main/src/services/exportFileService.js"
click node_edit_tools "https://github.com/pavol-humeny/figurio/tree/main/src/composables/tools"
click node_frame_tool "https://github.com/pavol-humeny/figurio/blob/main/src/composables/tools/useFrameTool.js"
click node_pipeline "https://github.com/pavol-humeny/figurio/blob/main/src/composables/editor/useImagePipeline.js"
click node_operations "https://github.com/pavol-humeny/figurio/tree/main/src/composables/editor/operations"
click node_tool_ui "https://github.com/pavol-humeny/figurio/tree/main/src/components/toolsSettings"
click node_image_state "https://github.com/pavol-humeny/figurio/blob/main/src/stores/imageStore.js"
click node_history "https://github.com/pavol-humeny/figurio/blob/main/src/stores/historyStore.js"
click node_workspace "https://github.com/pavol-humeny/figurio/blob/main/src/stores/workspaceStore.js"
click node_viewport "https://github.com/pavol-humeny/figurio/blob/main/src/stores/viewportStore.js"
click node_ui_state "https://github.com/pavol-humeny/figurio/blob/main/src/stores/uiStore.js"
click node_stats_pages "https://github.com/pavol-humeny/figurio/blob/main/src/views/StatisticsView.vue"
click node_stats_api "https://github.com/pavol-humeny/figurio/blob/main/src/composables/common/useApi.js"

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_entry,node_routing,node_editor_view,node_user toneBlue
class node_file_drop,node_file_ingest,node_export,node_edit_tools,node_frame_tool,node_pipeline,node_operations,node_tool_ui toneAmber
class node_image_state,node_history,node_workspace,node_viewport,node_ui_state toneMint
class node_stats_pages,node_stats_api,node_stats_service toneRose
```

## Components

### Application

- [App shell](https://github.com/pavol-humeny/figurio/blob/main/src/App.vue): `src/App.vue`
- [Page routing](https://github.com/pavol-humeny/figurio/blob/main/src/router/index.js): `src/router/index.js`
- [Editor page](https://github.com/pavol-humeny/figurio/blob/main/src/views/EditorView.vue): `src/views/EditorView.vue`

### Editing Workflow

- [File drop UI](https://github.com/pavol-humeny/figurio/blob/main/src/components/editor/DragAndDropArea.vue): `src/components/editor/DragAndDropArea.vue`
- [Import files](https://github.com/pavol-humeny/figurio/blob/main/src/services/importFileService.js): `src/services/importFileService.js`
- [Export files](https://github.com/pavol-humeny/figurio/blob/main/src/services/exportFileService.js): `src/services/exportFileService.js`
- [Image tools](https://github.com/pavol-humeny/figurio/tree/main/src/composables/tools): `src/composables/tools`
- [Frame tool](https://github.com/pavol-humeny/figurio/blob/main/src/composables/tools/useFrameTool.js): `src/composables/tools/useFrameTool.js`
- [Image pipeline](https://github.com/pavol-humeny/figurio/blob/main/src/composables/editor/useImagePipeline.js): `src/composables/editor/useImagePipeline.js`
- [Image operations](https://github.com/pavol-humeny/figurio/tree/main/src/composables/editor/operations): `src/composables/editor/operations`
- [Tool panels](https://github.com/pavol-humeny/figurio/tree/main/src/components/toolsSettings): `src/components/toolsSettings`

### Editor State

- [Image state](https://github.com/pavol-humeny/figurio/blob/main/src/stores/imageStore.js): `src/stores/imageStore.js`
- [Undo redo](https://github.com/pavol-humeny/figurio/blob/main/src/stores/historyStore.js): `src/stores/historyStore.js`
- [Workspace tabs](https://github.com/pavol-humeny/figurio/blob/main/src/stores/workspaceStore.js): `src/stores/workspaceStore.js`
- [Viewport state](https://github.com/pavol-humeny/figurio/blob/main/src/stores/viewportStore.js): `src/stores/viewportStore.js`
- [UI preferences](https://github.com/pavol-humeny/figurio/blob/main/src/stores/uiStore.js): `src/stores/uiStore.js`

### Usage Insights

- [Statistics pages](https://github.com/pavol-humeny/figurio/blob/main/src/views/StatisticsView.vue): `src/views/StatisticsView.vue`
- [Usage statistics API](https://github.com/pavol-humeny/figurio/blob/main/src/composables/common/useApi.js): `src/composables/common/useApi.js`
- **Statistics service**

### Other components

- **Editor user**

## Connections

- Editor user → App shell: uses
- App shell → Page routing: loads routes (evidence: `src/main.js`)
- Page routing → Editor page: routes to (evidence: `src/router/index.js`)
- Editor user → File drop UI: drops files
- Editor page → File drop UI: includes
- File drop UI → Import files: delegates import
- Editor user → Image tools: edits image
- Tool panels → Image tools: configures tools
- Frame tool → Image pipeline: applies operations (evidence: `src/composables/tools/useFrameTool.js`)
- Image pipeline → Image operations: dispatches operations (evidence: `src/composables/editor/useImagePipeline.js`)
- Image pipeline → Image state: updates image (evidence: `src/composables/editor/useImagePipeline.js`)
- Image state → Frame tool: uses frame logic (evidence: `src/stores/imageStore.js`)
- Image state → Undo redo: uses history (evidence: `src/stores/imageStore.js`)
- Workspace tabs → Image state: snapshots state (evidence: `src/stores/workspaceStore.js`)
- Workspace tabs → Undo redo: snapshots history (evidence: `src/stores/workspaceStore.js`)
- Workspace tabs → Viewport state: snapshots viewport (evidence: `src/stores/workspaceStore.js`)
- Editor user → Export files: exports result
- Statistics pages → Usage statistics API: requests statistics
- Usage statistics API → UI preferences: reads user ID (evidence: `src/composables/common/useApi.js`)
- Usage statistics API → Statistics service: fetches statistics
