# jerrylove77/aimloom architecture

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

- Interactive diagram: https://gitdiagram.com/jerrylove77/aimloom
- Repository: https://github.com/jerrylove77/aimloom

## Overview

Aimloom is a Windows KovaaK’s configuration manager and a companion sharing website. In the app, players locate the game, inspect or import content, review changes, then apply them through the Rust engine, which protects writes with backups and recovery. Other app capabilities include profiles, themes, sounds, crosshairs, and enemy skins. The website provides community discovery, uploads, feedback, and a browser-only crosshair tool. Shared packages parse themes and crosshair codes and render previews. Edges reflect README statements and the supplied source index or excerpts; unsampled implementation details are not asserted.

Main entry points: [`packages/app/src/workspace/Workspace.tsx`](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/workspace/Workspace.tsx) (Workspace), [`packages/site/src/pages`](https://github.com/jerrylove77/aimloom/tree/main/packages/site/src/pages) (Website pages), [`packages/app/src/bridge/contracts.ts`](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/bridge/contracts.ts) (App bridge), [`packages/app/src`](https://github.com/jerrylove77/aimloom/tree/main/packages/app/src) (Theme, sound, crosshair, enemy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_workspace["Workspace<br/>[Workspace.tsx]"]
  node_quickimport["Quick import"]
  node_sections["Theme, sound, crosshair, enemy"]
  node_profiles["Profiles"]
  node_installerui["Backup and restore UI"]
  node_bridge["App bridge<br/>[contracts.ts]"]
  node_crosshairui["Crosshair export"]
end

subgraph group_engine["Native engine"]
  node_rustengine["Game file engine"]
  node_nativeinstaller["Installer worker<br/>[worker.rs]"]
end

subgraph group_community["Community website"]
  node_website["Website pages"]
  node_explore["Explore catalogue<br/>[explore.ts]"]
  node_uploads["Upload and review<br/>[uploads.ts]"]
  node_steam["Steam sign-in<br/>[auth.ts]"]
  node_feedback["Feedback tickets<br/>[tickets.ts]"]
  node_turnstile["Turnstile verification"]
end

subgraph group_shared["Shared libraries"]
  node_theme["Theme parsing<br/>[document.ts]"]
  node_crosshair["Crosshair parsing and rendering<br/>[render.ts]"]
end

node_player(("Player"))
node_sitevisitor(("Website visitor"))

node_player -->|"uses"| node_workspace
node_workspace -->|"opens"| node_quickimport
node_workspace -->|"opens"| node_sections
node_workspace -->|"opens"| node_profiles
node_workspace -->|"opens"| node_installerui
node_quickimport -->|"plans and applies"| node_bridge
node_sections -->|"reads and writes"| node_bridge
node_profiles -->|"applies snapshot"| node_bridge
node_installerui -->|"manages jobs"| node_nativeinstaller
node_bridge -->|"routes game operations"| node_rustengine
node_rustengine -.->|"protects writes"| node_nativeinstaller
node_sections -->|"previews themes"| node_theme
node_crosshairui -->|"renders PNG"| node_crosshair
node_player -->|"browses and submits"| node_website
node_website -->|"browses content"| node_explore
node_website -->|"submits files"| node_uploads
node_website -->|"submits tickets"| node_feedback
node_uploads -->|"authenticates author"| node_steam
node_uploads -->|"verifies human"| node_turnstile
node_website -->|"previews codes"| node_crosshair

click node_workspace "https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/workspace/Workspace.tsx"
click node_quickimport "https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/explore/import-controller.ts"
click node_sections "https://github.com/jerrylove77/aimloom/tree/main/packages/app/src"
click node_profiles "https://github.com/jerrylove77/aimloom/tree/main/packages/app/src/profiles"
click node_installerui "https://github.com/jerrylove77/aimloom/tree/main/packages/app/src/installer"
click node_bridge "https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/bridge/contracts.ts"
click node_crosshairui "https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/crosshair/export-controller.ts"
click node_rustengine "https://github.com/jerrylove77/aimloom/tree/main/packages/app/src-tauri/src/engine"
click node_nativeinstaller "https://github.com/jerrylove77/aimloom/blob/main/packages/app/src-tauri/src/installer/worker.rs"
click node_theme "https://github.com/jerrylove77/aimloom/blob/main/packages/theme/src/theme/document.ts"
click node_crosshair "https://github.com/jerrylove77/aimloom/blob/main/packages/crosshair/src/render.ts"
click node_website "https://github.com/jerrylove77/aimloom/tree/main/packages/site/src/pages"
click node_explore "https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/explore.ts"
click node_uploads "https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/uploads.ts"
click node_steam "https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/auth.ts"
click node_feedback "https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/tickets.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_workspace,node_quickimport,node_sections,node_profiles,node_installerui,node_bridge,node_crosshairui toneBlue
class node_rustengine,node_nativeinstaller toneAmber
class node_website,node_explore,node_uploads,node_steam,node_feedback,node_turnstile toneMint
class node_theme,node_crosshair toneRose
class node_player,node_sitevisitor toneIndigo
```

## Components

### Desktop app

- [Workspace](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/workspace/Workspace.tsx): `packages/app/src/workspace/Workspace.tsx`
- [Quick import](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/explore/import-controller.ts): `packages/app/src/explore/import-controller.ts`
- [Theme, sound, crosshair, enemy](https://github.com/jerrylove77/aimloom/tree/main/packages/app/src): `packages/app/src`
- [Profiles](https://github.com/jerrylove77/aimloom/tree/main/packages/app/src/profiles): `packages/app/src/profiles`
- [Backup and restore UI](https://github.com/jerrylove77/aimloom/tree/main/packages/app/src/installer): `packages/app/src/installer`
- [App bridge](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/bridge/contracts.ts): `packages/app/src/bridge/contracts.ts`
- [Crosshair export](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src/crosshair/export-controller.ts): `packages/app/src/crosshair/export-controller.ts`

### Native engine

- [Game file engine](https://github.com/jerrylove77/aimloom/tree/main/packages/app/src-tauri/src/engine): `packages/app/src-tauri/src/engine`
- [Installer worker](https://github.com/jerrylove77/aimloom/blob/main/packages/app/src-tauri/src/installer/worker.rs): `packages/app/src-tauri/src/installer/worker.rs`

### Community website

- [Website pages](https://github.com/jerrylove77/aimloom/tree/main/packages/site/src/pages): `packages/site/src/pages`
- [Explore catalogue](https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/explore.ts): `packages/site/src/worker/explore.ts`
- [Upload and review](https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/uploads.ts): `packages/site/src/worker/uploads.ts`
- [Steam sign-in](https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/auth.ts): `packages/site/src/worker/auth.ts`
- [Feedback tickets](https://github.com/jerrylove77/aimloom/blob/main/packages/site/src/worker/tickets.ts): `packages/site/src/worker/tickets.ts`
- **Turnstile verification**

### Shared libraries

- [Theme parsing](https://github.com/jerrylove77/aimloom/blob/main/packages/theme/src/theme/document.ts): `packages/theme/src/theme/document.ts`
- [Crosshair parsing and rendering](https://github.com/jerrylove77/aimloom/blob/main/packages/crosshair/src/render.ts): `packages/crosshair/src/render.ts`

### Other components

- **Player**
- **Website visitor**

## Connections

- Player → Workspace: uses
- Workspace → Quick import: opens
- Workspace → Theme, sound, crosshair, enemy: opens (evidence: `packages/app/src/main.tsx`)
- Workspace → Profiles: opens
- Workspace → Backup and restore UI: opens
- Quick import → App bridge: plans and applies (evidence: `packages/app/src/explore/import-controller.ts`)
- Theme, sound, crosshair, enemy → App bridge: reads and writes (evidence: `packages/app/src/audio/controller.ts`)
- Profiles → App bridge: applies snapshot (evidence: `packages/app/src/profiles/apply-controller.ts`)
- Backup and restore UI → Installer worker: manages jobs (evidence: `packages/app/src-tauri/src/installer/worker.rs`)
- App bridge → Game file engine: routes game operations
- Game file engine → Installer worker: protects writes
- Theme, sound, crosshair, enemy → Theme parsing: previews themes
- Crosshair export → Crosshair parsing and rendering: renders PNG (evidence: `packages/app/src/crosshair/export-controller.ts`)
- Player → Website pages: browses and submits
- Website pages → Explore catalogue: browses content
- Website pages → Upload and review: submits files
- Website pages → Feedback tickets: submits tickets
- Upload and review → Steam sign-in: authenticates author
- Upload and review → Turnstile verification: verifies human
- Website pages → Crosshair parsing and rendering: previews codes
