# dextryayers/avero architecture

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

- Interactive diagram: https://gitdiagram.com/dextryayers/avero
- Repository: https://github.com/dextryayers/avero

## Overview

AVERO STUDIO is an offline desktop raster editor. The primary workflow is opening or creating a document, editing it on the canvas with layers, selections and non-destructive effects, then saving the editable .avx project or exporting an image. The map also preserves documented conversion, RAW, background removal/segmentation, native processing and tiled-memory capabilities. Some subsystem paths and links are based on README or registration evidence rather than inspected implementation excerpts; those links are dashed where runtime wiring is unverified.

Main entry points: [`src/components/CanvasArea.tsx`](https://github.com/dextryayers/avero/blob/main/src/components/CanvasArea.tsx) (Canvas editor), [`src-tauri/src/lib.rs`](https://github.com/dextryayers/avero/blob/main/src-tauri/src/lib.rs) (Tauri command host), [`src/io/projectIo.ts`](https://github.com/dextryayers/avero/blob/main/src/io/projectIo.ts) (AVX projects), [`src/components/HomeScreen.tsx`](https://github.com/dextryayers/avero/blob/main/src/components/HomeScreen.tsx) (Home screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Studio UI"]
  node_home["Home screen<br/>[HomeScreen.tsx]"]
  node_app["App shell<br/>[App.tsx]"]
  node_toolbar["Tool selection<br/>[ToolBar.tsx]"]
  node_canvas["Canvas editor<br/>[CanvasArea.tsx]"]
end

subgraph group_edit["Editing Engine"]
  node_selection["Selection tools<br/>[selection.ts]"]
  node_layers["Layer pixels &amp; masks<br/>[layerManager.ts]"]
  node_effects["Adjustments &amp; filters"]
  node_tiled["Tiled rendering<br/>[tiledRenderer.ts]"]
end

subgraph group_io["Documents &amp; Export"]
  node_import["Image import<br/>[importImage.ts]"]
  node_project["AVX projects<br/>[projectIo.ts]"]
  node_export["Image export<br/>[exportRunner.ts]"]
  node_convert["Format conversion<br/>[convert.ts]"]
  node_tauri["Desktop file bridge<br/>[tauriIo.ts]"]
  node_memory["Memory manager<br/>[memoryManager.ts]"]
end

subgraph group_native["Native Processing"]
  node_backend["Tauri command host<br/>[lib.rs]"]
  node_nativeengine["Native C/C++ engine<br/>[native.rs]"]
  node_nativec["C pixel operations<br/>[image_ops.c]"]
  node_nativefilters["C++ filters<br/>[filters.cpp]"]
  node_rmbg["Background removal<br/>[rmbg.rs]"]
  node_segment["Image segmentation<br/>[segment.rs]"]
  node_ram["Memory planning<br/>[ram.rs]"]
end

subgraph group_state["State &amp; Settings"]
  node_editorstate["Document state<br/>[useEditorStore.ts]"]
  node_prostate["Pro editing state<br/>[useProStore.ts]"]
  node_settings["Preferences"]
end

node_user(("Editor"))

node_user -->|"starts workflow"| node_home
node_user -->|"chooses tools"| node_toolbar
node_home -->|"opens images"| node_import
node_home -->|"opens projects"| node_project
node_app -->|"saves projects"| node_project
node_toolbar -.->|"selects editing tools"| node_canvas
node_canvas -->|"updates document state"| node_editorstate
node_canvas -->|"uses pro state"| node_prostate
node_canvas -->|"reads and writes pixels"| node_layers
node_canvas -->|"uses selections"| node_selection
node_canvas -->|"renders layer effects"| node_effects
node_editorstate -->|"sets history limit"| node_settings
node_import -->|"loads document"| node_editorstate
node_import -->|"uses desktop IO"| node_tauri
node_project -->|"restores document"| node_editorstate
node_project -->|"reads layer pixels"| node_layers
node_project -->|"reads and writes files"| node_tauri
node_canvas -.->|"exports image"| node_export
node_home -->|"opens converter"| node_convert
node_memory -->|"reads light-mode setting"| node_settings
node_memory -->|"requests memory budget"| node_backend
node_backend -->|"registers commands"| node_nativeengine
node_backend -.->|"registers commands"| node_rmbg
node_backend -.->|"registers commands"| node_segment
node_backend -->|"registers budget commands"| node_ram
node_nativeengine -->|"calls C operations"| node_nativec
node_nativeengine -->|"calls C++ filters"| node_nativefilters
node_nativeengine -.->|"supports tiled processing"| node_tiled
node_rmbg -->|"uses segmentation"| node_segment

click node_home "https://github.com/dextryayers/avero/blob/main/src/components/HomeScreen.tsx"
click node_app "https://github.com/dextryayers/avero/blob/main/src/App.tsx"
click node_toolbar "https://github.com/dextryayers/avero/blob/main/src/components/ToolBar.tsx"
click node_canvas "https://github.com/dextryayers/avero/blob/main/src/components/CanvasArea.tsx"
click node_selection "https://github.com/dextryayers/avero/blob/main/src/engine/selection.ts"
click node_layers "https://github.com/dextryayers/avero/blob/main/src/engine/layerManager.ts"
click node_effects "https://github.com/dextryayers/avero/tree/main/src/engine"
click node_tiled "https://github.com/dextryayers/avero/blob/main/src/engine/tiledRenderer.ts"
click node_editorstate "https://github.com/dextryayers/avero/blob/main/src/stores/useEditorStore.ts"
click node_prostate "https://github.com/dextryayers/avero/blob/main/src/stores/useProStore.ts"
click node_settings "https://github.com/dextryayers/avero/blob/main/src/stores/useSettingsStore.ts"
click node_import "https://github.com/dextryayers/avero/blob/main/src/io/importImage.ts"
click node_project "https://github.com/dextryayers/avero/blob/main/src/io/projectIo.ts"
click node_export "https://github.com/dextryayers/avero/blob/main/src/io/exportRunner.ts"
click node_convert "https://github.com/dextryayers/avero/blob/main/src/io/convert.ts"
click node_tauri "https://github.com/dextryayers/avero/blob/main/src/io/tauriIo.ts"
click node_backend "https://github.com/dextryayers/avero/blob/main/src-tauri/src/lib.rs"
click node_nativeengine "https://github.com/dextryayers/avero/blob/main/src-tauri/src/native.rs"
click node_nativec "https://github.com/dextryayers/avero/blob/main/src-tauri/native/image_ops.c"
click node_nativefilters "https://github.com/dextryayers/avero/blob/main/src-tauri/native/filters.cpp"
click node_rmbg "https://github.com/dextryayers/avero/blob/main/src-tauri/src/rmbg.rs"
click node_segment "https://github.com/dextryayers/avero/blob/main/src-tauri/src/segment.rs"
click node_ram "https://github.com/dextryayers/avero/blob/main/src-tauri/src/ram.rs"
click node_memory "https://github.com/dextryayers/avero/blob/main/src/io/memoryManager.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_home,node_app,node_toolbar,node_canvas toneBlue
class node_selection,node_layers,node_effects,node_tiled toneAmber
class node_import,node_project,node_export,node_convert,node_tauri,node_memory toneMint
class node_backend,node_nativeengine,node_nativec,node_nativefilters,node_rmbg,node_segment,node_ram toneRose
class node_editorstate,node_prostate,node_settings,node_user toneIndigo
```

## Components

### Studio UI

- [Home screen](https://github.com/dextryayers/avero/blob/main/src/components/HomeScreen.tsx): `src/components/HomeScreen.tsx`
- [App shell](https://github.com/dextryayers/avero/blob/main/src/App.tsx): `src/App.tsx`
- [Tool selection](https://github.com/dextryayers/avero/blob/main/src/components/ToolBar.tsx): `src/components/ToolBar.tsx`
- [Canvas editor](https://github.com/dextryayers/avero/blob/main/src/components/CanvasArea.tsx): `src/components/CanvasArea.tsx`

### Editing Engine

- [Selection tools](https://github.com/dextryayers/avero/blob/main/src/engine/selection.ts): `src/engine/selection.ts`
- [Layer pixels & masks](https://github.com/dextryayers/avero/blob/main/src/engine/layerManager.ts): `src/engine/layerManager.ts`
- [Adjustments & filters](https://github.com/dextryayers/avero/tree/main/src/engine): `src/engine`
- [Tiled rendering](https://github.com/dextryayers/avero/blob/main/src/engine/tiledRenderer.ts): `src/engine/tiledRenderer.ts`

### Documents & Export

- [Image import](https://github.com/dextryayers/avero/blob/main/src/io/importImage.ts): `src/io/importImage.ts`
- [AVX projects](https://github.com/dextryayers/avero/blob/main/src/io/projectIo.ts): `src/io/projectIo.ts`
- [Image export](https://github.com/dextryayers/avero/blob/main/src/io/exportRunner.ts): `src/io/exportRunner.ts`
- [Format conversion](https://github.com/dextryayers/avero/blob/main/src/io/convert.ts): `src/io/convert.ts`
- [Desktop file bridge](https://github.com/dextryayers/avero/blob/main/src/io/tauriIo.ts): `src/io/tauriIo.ts`
- [Memory manager](https://github.com/dextryayers/avero/blob/main/src/io/memoryManager.ts): `src/io/memoryManager.ts`

### Native Processing

- [Tauri command host](https://github.com/dextryayers/avero/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Native C/C++ engine](https://github.com/dextryayers/avero/blob/main/src-tauri/src/native.rs): `src-tauri/src/native.rs`
- [C pixel operations](https://github.com/dextryayers/avero/blob/main/src-tauri/native/image_ops.c): `src-tauri/native/image_ops.c`
- [C++ filters](https://github.com/dextryayers/avero/blob/main/src-tauri/native/filters.cpp): `src-tauri/native/filters.cpp`
- [Background removal](https://github.com/dextryayers/avero/blob/main/src-tauri/src/rmbg.rs): `src-tauri/src/rmbg.rs`
- [Image segmentation](https://github.com/dextryayers/avero/blob/main/src-tauri/src/segment.rs): `src-tauri/src/segment.rs`
- [Memory planning](https://github.com/dextryayers/avero/blob/main/src-tauri/src/ram.rs): `src-tauri/src/ram.rs`

### State & Settings

- [Document state](https://github.com/dextryayers/avero/blob/main/src/stores/useEditorStore.ts): `src/stores/useEditorStore.ts`
- [Pro editing state](https://github.com/dextryayers/avero/blob/main/src/stores/useProStore.ts): `src/stores/useProStore.ts`
- [Preferences](https://github.com/dextryayers/avero/blob/main/src/stores/useSettingsStore.ts): `src/stores/useSettingsStore.ts`

### Other components

- **Editor**

## Connections

- Editor → Home screen: starts workflow
- Editor → Tool selection: chooses tools
- Home screen → Image import: opens images (evidence: `src/components/HomeScreen.tsx`)
- Home screen → AVX projects: opens projects (evidence: `src/components/HomeScreen.tsx`)
- App shell → AVX projects: saves projects (evidence: `src/App.tsx`)
- Tool selection → Canvas editor: selects editing tools (evidence: `src/components/CanvasArea.tsx`)
- Canvas editor → Document state: updates document state (evidence: `src/components/CanvasArea.tsx`)
- Canvas editor → Pro editing state: uses pro state (evidence: `src/components/CanvasArea.tsx`)
- Canvas editor → Layer pixels & masks: reads and writes pixels (evidence: `src/components/CanvasArea.tsx`)
- Canvas editor → Selection tools: uses selections (evidence: `src/components/CanvasArea.tsx`)
- Canvas editor → Adjustments & filters: renders layer effects (evidence: `src/components/CanvasArea.tsx`)
- Document state → Preferences: sets history limit (evidence: `src/stores/useEditorStore.ts`)
- Image import → Document state: loads document (evidence: `src/io/importImage.ts`)
- Image import → Desktop file bridge: uses desktop IO (evidence: `src/io/importImage.ts`)
- AVX projects → Document state: restores document (evidence: `src/io/projectIo.ts`)
- AVX projects → Layer pixels & masks: reads layer pixels (evidence: `src/io/projectIo.ts`)
- AVX projects → Desktop file bridge: reads and writes files (evidence: `src/io/projectIo.ts`)
- Canvas editor → Image export: exports image
- Home screen → Format conversion: opens converter (evidence: `src/components/HomeScreen.tsx`)
- Memory manager → Preferences: reads light-mode setting (evidence: `src/io/memoryManager.ts`)
- Memory manager → Tauri command host: requests memory budget (evidence: `src/io/memoryManager.ts`)
- Tauri command host → Native C/C++ engine: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command host → Background removal: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command host → Image segmentation: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command host → Memory planning: registers budget commands (evidence: `src-tauri/src/lib.rs`)
- Native C/C++ engine → C pixel operations: calls C operations
- Native C/C++ engine → C++ filters: calls C++ filters
- Native C/C++ engine → Tiled rendering: supports tiled processing
- Background removal → Image segmentation: uses segmentation (evidence: `src-tauri/src/rmbg.rs`)
