# s0udiz/aimagery architecture

> Architecture diagram of the GitHub repository s0udiz/aimagery, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/s0udiz/aimagery
- Repository: https://github.com/s0udiz/aimagery

## Overview

##### Project type and purpose
- This is a desktop application built with Tauri (Rust) for the backend and a Svelte/Vite-powered frontend.
- Its purpose is to let users generate and view images by invoking models hosted on Replicate.com.

##### File-structure snapshot and architectural clues
- Top-level:
- src/ → Svelte application (app.html, app.css), component library (src/lib), page routes (src/routes), context stores
- schemas/, components.json, llms-small.txt → JSON schemas and static configuration for models
- vite.config.js, svelte.config.js, tsconfig.json → build and type-checking setup
- Key patterns:
- Component-driven UI in Svelte (src/lib/components/ui)
- IPC boundary between frontend and Rust via tauri.invoke calls
- External HTTP integration with Replicate via Rust

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend: Svelte App"
        direction TB
        AppHTML["app.html"]:::frontend
        AppCSS["app.css"]:::frontend
        subgraph "Page Routes"
            direction TB
            Home["Home Page (+page.svelte)"]:::frontend
            Models["Models Page (+page.svelte)"]:::frontend
            LayoutSvelte["Layout (+layout.svelte)"]:::frontend
            LayoutTS["Layout Logic (+layout.ts)"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            Button["Button"]:::frontend
            Dialog["Dialog Components"]:::frontend
            Input["Input"]:::frontend
            Sidebar["Sidebar"]:::frontend
        end
        subgraph "Context Stores"
            direction TB
            CreatedModels["createdModels"]:::frontend
            LoadedModel["loadedModel"]:::frontend
            Settings["settings"]:::frontend
        end
        subgraph "Utils & Hooks"
            direction TB
            Utils["utils.ts"]:::frontend
            IsMobile["is-mobile.ts"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "Backend: Rust/Tauri"
        direction TB
        MainRs["main.rs"]:::backend
        LibRs["lib.rs"]:::backend
        Cargo["Cargo.toml"]:::backend
        TauriConf["tauri.conf.json"]:::backend
        BuildRs["build.rs"]:::backend
        Capabilities["capabilities/default.json"]:::backend
        Icons["icons/"]:::backend
    end

    %% External Service
    Replicate["Replicate.com API"]:::external

    %% Local Config & Assets
    subgraph "Local Config & Assets"
        direction TB
        Schema["schemas/model_info.json"]:::storage
        ComponentsCfg["components.json"]:::storage
        Hints["llms-small.txt"]:::storage
        StaticAssets["static/"]:::storage
    end

    %% Operating System Services
    OS["OS Services\n(File system, Network)"]:::infra

    %% Data Flows
    Home -->|"invoke generate_image"| MainRs
    MainRs -->|"reads config"| Schema
    MainRs -->|"reads config"| ComponentsCfg
    MainRs -->|"reads hints"| Hints
    MainRs -->|"HTTP request"| Replicate
    Replicate -->|"HTTP response"| MainRs
    MainRs -->|"invoke response"| Home
    Home -->|"invoke save"| MainRs
    MainRs -->|"write file"| OS
    MainRs -->|"load assets"| StaticAssets
    MainRs -->|"access icons"| Icons

    %% Click Events
    click AppHTML "https://github.com/s0udiz/aimagery/blob/main/src/app.html"
    click AppCSS "https://github.com/s0udiz/aimagery/blob/main/src/app.css"
    click Home "https://github.com/s0udiz/aimagery/blob/main/src/routes/+page.svelte"
    click Models "https://github.com/s0udiz/aimagery/blob/main/src/routes/models/+page.svelte"
    click LayoutSvelte "https://github.com/s0udiz/aimagery/blob/main/src/routes/+layout.svelte"
    click LayoutTS "https://github.com/s0udiz/aimagery/blob/main/src/routes/+layout.ts"
    click Button "https://github.com/s0udiz/aimagery/blob/main/src/lib/components/ui/button/button.svelte"
    click Dialog "https://github.com/s0udiz/aimagery/tree/main/src/lib/components/ui/dialog"
    click Input "https://github.com/s0udiz/aimagery/blob/main/src/lib/components/ui/input/input.svelte"
    click Sidebar "https://github.com/s0udiz/aimagery/blob/main/src/lib/components/ui/sidebar/sidebar.svelte"
    click CreatedModels "https://github.com/s0udiz/aimagery/blob/main/src/lib/context/createdModels.ts"
    click LoadedModel "https://github.com/s0udiz/aimagery/blob/main/src/lib/context/loadedModel.ts"
    click Settings "https://github.com/s0udiz/aimagery/blob/main/src/lib/context/settings.ts"
    click Utils "https://github.com/s0udiz/aimagery/blob/main/src/lib/utils.ts"
    click IsMobile "https://github.com/s0udiz/aimagery/blob/main/src/lib/hooks/is-mobile.svelte.ts"
    click MainRs "https://github.com/s0udiz/aimagery/blob/main/src-tauri/src/main.rs"
    click LibRs "https://github.com/s0udiz/aimagery/blob/main/src-tauri/src/lib.rs"
    click Cargo "https://github.com/s0udiz/aimagery/blob/main/src-tauri/Cargo.toml"
    click TauriConf "https://github.com/s0udiz/aimagery/blob/main/src-tauri/tauri.conf.json"
    click BuildRs "https://github.com/s0udiz/aimagery/blob/main/src-tauri/build.rs"
    click Capabilities "https://github.com/s0udiz/aimagery/blob/main/src-tauri/capabilities/default.json"
    click Icons "https://github.com/s0udiz/aimagery/tree/main/src-tauri/icons"
    click Schema "https://github.com/s0udiz/aimagery/blob/main/schemas/model_info.json"
    click ComponentsCfg "https://github.com/s0udiz/aimagery/blob/main/components.json"
    click Hints "https://github.com/s0udiz/aimagery/blob/main/llms-small.txt"
    click StaticAssets "https://github.com/s0udiz/aimagery/tree/main/static/"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,stroke-width:2px;
    classDef backend fill:#DFFFE0,stroke:#228B22,stroke-width:2px;
    classDef external fill:#FFE0B2,stroke:#FF8C00,stroke-width:2px;
    classDef storage fill:#F0F0F0,stroke:#666666,stroke-width:1px;
    classDef infra fill:#FFEFEF,stroke:#B22222,stroke-width:1px;
```
