# bacoinz/pes-kitlab architecture

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

- Interactive diagram: https://gitdiagram.com/bacoinz/pes-kitlab
- Repository: https://github.com/bacoinz/pes-kitlab

## Overview

PES KitLab is a desktop kit-design and export app for Football Life/PES and Sider. A user selects a game folder, browses teams and their existing kits, edits a kit in 2D with a live 3D preview (or generates kits in bulk from templates), then exports changes to the kit-server or restores originals. The frontend and Rust game-access/export core are distinct layers. The README documents the product flow; some frontend-to-Rust wiring and unsampled subsystem details are not shown, so those links are omitted or marked unverified.

Main entry points: [`app-tauri/src/compositor/compose.ts`](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/compose.ts) (Texture compositor), [`app-tauri/src/state.ts`](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/state.ts) (Project state), [`app-tauri/src-tauri/src/store.rs`](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/store.rs) (Game data store), [`app-tauri/src/App.tsx`](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/App.tsx) (Application shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["Application shell<br/>[App.tsx]"]
  node_state["Project state<br/>[state.ts]"]
  node_teams["Teams browser<br/>[Teams.tsx]"]
end

subgraph group_design["Kit design"]
  node_editor["Kit editor<br/>[Editor.tsx]"]
  node_bulk["Bulk generation<br/>[Bulk.tsx]"]
  node_designmodel["Design model<br/>[design.ts]"]
  node_templates["Kit templates<br/>[templates.ts]"]
  node_compositor["Texture compositor<br/>[compose.ts]"]
  node_gpu["GPU rendering<br/>[gpu.ts]"]
  node_uv["Texture mapping<br/>[uv.ts]"]
  node_designs["Pattern designs<br/>[designs.ts]"]
  node_patterns["Custom patterns<br/>[patterns.ts]"]
end

subgraph group_preview["Preview and assets"]
  node_images["Image assets<br/>[images.ts]"]
  node_fabric["Fabric effects<br/>[fabric.ts]"]
  node_kitviewer["3D kit viewer<br/>[KitViewer.tsx]"]
  node_comet["Game model assets<br/>[comet.ts]"]
  node_previews["Design previews<br/>[previews.ts]"]
end

subgraph group_game["Game access"]
  node_ipc["Desktop IPC<br/>[ipc.ts]"]
  node_rustcore["Rust game core<br/>[lib.rs]"]
  node_store["Game data store<br/>[store.rs]"]
  node_indexer["Game file index<br/>[index.rs]"]
  node_teamsdata["Team data<br/>[teams.rs]"]
  node_tex["Texture codec<br/>[tex.rs]"]
end

subgraph group_export["Kit-server export"]
  node_kitserver["Kit-server files<br/>[kitserver.rs]"]
end

node_user(("Kit designer"))
node_sider[("Sider kit-server")]
node_gamefolder[("Game folder")]

node_user -->|"opens and selects"| node_app
node_app -->|"reads project state"| node_state
node_app -->|"routes to"| node_teams
node_app -->|"routes to"| node_editor
node_app -->|"routes to"| node_bulk
node_user -->|"chooses team"| node_teams
node_teams -->|"reads team state"| node_state
node_user -->|"edits kit"| node_editor
node_editor -->|"updates project"| node_state
node_editor -->|"composes texture"| node_compositor
node_editor -->|"shows preview"| node_kitviewer
node_bulk -->|"generates kit set"| node_templates
node_bulk -->|"composes kits"| node_compositor
node_bulk -->|"loads project"| node_state
node_state -->|"generates templates"| node_templates
node_state -->|"composes texture"| node_compositor
node_compositor -->|"reads design"| node_designmodel
node_compositor -->|"maps texture regions"| node_uv
node_compositor -->|"draws patterns"| node_patterns
node_compositor -->|"loads images"| node_images
node_compositor -->|"applies fabric"| node_fabric
node_compositor -->|"renders designs"| node_designs
node_compositor -->|"uses rendering"| node_gpu
node_compositor -->|"reads collar model"| node_comet
node_kitviewer -->|"loads model assets"| node_comet
node_previews -->|"composes thumbnails"| node_compositor
node_previews -->|"applies template"| node_templates
node_previews -->|"draws texture preview"| node_patterns
node_user -->|"selects game folder"| node_gamefolder
node_state -.->|"requests game access"| node_ipc
node_ipc -.->|"invokes commands"| node_rustcore
node_rustcore -->|"delegates game data"| node_store
node_store -->|"indexes game files"| node_indexer
node_store -->|"reads teams"| node_teamsdata
node_store -->|"decodes textures"| node_tex
node_store -->|"reads kit files"| node_kitserver
node_indexer -->|"reads game archives"| node_gamefolder
node_user -->|"exports changes"| node_sider
node_rustcore -->|"writes kit changes"| node_sider
node_store -.->|"exports and restores"| node_kitserver

click node_app "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/App.tsx"
click node_state "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/state.ts"
click node_teams "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Teams.tsx"
click node_editor "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Editor.tsx"
click node_bulk "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Bulk.tsx"
click node_designmodel "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/model/design.ts"
click node_templates "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/model/templates.ts"
click node_compositor "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/compose.ts"
click node_gpu "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/gpu.ts"
click node_uv "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/uv.ts"
click node_designs "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/designs.ts"
click node_patterns "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/patterns.ts"
click node_images "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/images.ts"
click node_fabric "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/fabric.ts"
click node_kitviewer "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/three/KitViewer.tsx"
click node_comet "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/three/comet.ts"
click node_previews "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/previews.ts"
click node_ipc "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/shared/ipc.ts"
click node_rustcore "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/lib.rs"
click node_store "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/store.rs"
click node_indexer "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/index.rs"
click node_teamsdata "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/teams.rs"
click node_tex "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/tex.rs"
click node_kitserver "https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/kitserver.rs"

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,node_state,node_teams toneBlue
class node_editor,node_bulk,node_designmodel,node_templates,node_compositor,node_gpu,node_uv,node_designs,node_patterns,node_sider,node_gamefolder toneAmber
class node_images,node_fabric,node_kitviewer,node_comet,node_previews toneMint
class node_ipc,node_rustcore,node_store,node_indexer,node_teamsdata,node_tex toneRose
class node_kitserver,node_user toneIndigo
```

## Components

### App shell

- [Application shell](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/App.tsx): `app-tauri/src/App.tsx`
- [Project state](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/state.ts): `app-tauri/src/state.ts`
- [Teams browser](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Teams.tsx): `app-tauri/src/ui/Teams.tsx`

### Kit design

- [Kit editor](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Editor.tsx): `app-tauri/src/ui/Editor.tsx`
- [Bulk generation](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/ui/Bulk.tsx): `app-tauri/src/ui/Bulk.tsx`
- [Design model](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/model/design.ts): `app-tauri/src/model/design.ts`
- [Kit templates](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/model/templates.ts): `app-tauri/src/model/templates.ts`
- [Texture compositor](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/compose.ts): `app-tauri/src/compositor/compose.ts`
- [GPU rendering](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/gpu.ts): `app-tauri/src/compositor/gpu.ts`
- [Texture mapping](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/uv.ts): `app-tauri/src/compositor/uv.ts`
- [Pattern designs](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/designs.ts): `app-tauri/src/compositor/designs.ts`
- [Custom patterns](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/patterns.ts): `app-tauri/src/compositor/patterns.ts`

### Preview and assets

- [Image assets](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/images.ts): `app-tauri/src/compositor/images.ts`
- [Fabric effects](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/compositor/fabric.ts): `app-tauri/src/compositor/fabric.ts`
- [3D kit viewer](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/three/KitViewer.tsx): `app-tauri/src/three/KitViewer.tsx`
- [Game model assets](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/three/comet.ts): `app-tauri/src/three/comet.ts`
- [Design previews](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/previews.ts): `app-tauri/src/previews.ts`

### Game access

- [Desktop IPC](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src/shared/ipc.ts): `app-tauri/src/shared/ipc.ts`
- [Rust game core](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/lib.rs): `app-tauri/src-tauri/src/lib.rs`
- [Game data store](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/store.rs): `app-tauri/src-tauri/src/store.rs`
- [Game file index](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/index.rs): `app-tauri/src-tauri/src/game/index.rs`
- [Team data](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/teams.rs): `app-tauri/src-tauri/src/game/teams.rs`
- [Texture codec](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/tex.rs): `app-tauri/src-tauri/src/game/tex.rs`

### Kit-server export

- [Kit-server files](https://github.com/bacoinz/pes-kitlab/blob/main/app-tauri/src-tauri/src/game/kitserver.rs): `app-tauri/src-tauri/src/game/kitserver.rs`

### Other components

- **Kit designer**
- **Sider kit-server**
- **Game folder**

## Connections

- Kit designer → Application shell: opens and selects (evidence: `README.md`)
- Application shell → Project state: reads project state (evidence: `app-tauri/src/App.tsx`)
- Application shell → Teams browser: routes to (evidence: `app-tauri/src/App.tsx`)
- Application shell → Kit editor: routes to (evidence: `app-tauri/src/App.tsx`)
- Application shell → Bulk generation: routes to (evidence: `app-tauri/src/App.tsx`)
- Kit designer → Teams browser: chooses team (evidence: `README.md`)
- Teams browser → Project state: reads team state (evidence: `app-tauri/src/ui/Teams.tsx`)
- Kit designer → Kit editor: edits kit (evidence: `README.md`)
- Kit editor → Project state: updates project (evidence: `app-tauri/src/ui/Editor.tsx`)
- Kit editor → Texture compositor: composes texture (evidence: `app-tauri/src/ui/Editor.tsx`)
- Kit editor → 3D kit viewer: shows preview (evidence: `app-tauri/src/ui/Editor.tsx`)
- Bulk generation → Kit templates: generates kit set (evidence: `app-tauri/src/ui/Bulk.tsx`)
- Bulk generation → Texture compositor: composes kits (evidence: `app-tauri/src/ui/Bulk.tsx`)
- Bulk generation → Project state: loads project (evidence: `app-tauri/src/ui/Bulk.tsx`)
- Project state → Kit templates: generates templates (evidence: `app-tauri/src/state.ts`)
- Project state → Texture compositor: composes texture (evidence: `app-tauri/src/state.ts`)
- Texture compositor → Design model: reads design (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Texture mapping: maps texture regions (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Custom patterns: draws patterns (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Image assets: loads images (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Fabric effects: applies fabric (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Pattern designs: renders designs (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → GPU rendering: uses rendering (evidence: `app-tauri/src/compositor/compose.ts`)
- Texture compositor → Game model assets: reads collar model (evidence: `app-tauri/src/compositor/compose.ts`)
- 3D kit viewer → Game model assets: loads model assets (evidence: `app-tauri/src/three/KitViewer.tsx`)
- Design previews → Texture compositor: composes thumbnails (evidence: `app-tauri/src/previews.ts`)
- Design previews → Kit templates: applies template (evidence: `app-tauri/src/previews.ts`)
- Design previews → Custom patterns: draws texture preview (evidence: `app-tauri/src/previews.ts`)
- Kit designer → Game folder: selects game folder
- Project state → Desktop IPC: requests game access
- Desktop IPC → Rust game core: invokes commands
- Rust game core → Game data store: delegates game data (evidence: `app-tauri/src-tauri/src/lib.rs`)
- Game data store → Game file index: indexes game files (evidence: `app-tauri/src-tauri/src/store.rs`)
- Game data store → Team data: reads teams (evidence: `app-tauri/src-tauri/src/store.rs`)
- Game data store → Texture codec: decodes textures (evidence: `app-tauri/src-tauri/src/store.rs`)
- Game data store → Kit-server files: reads kit files (evidence: `app-tauri/src-tauri/src/store.rs`)
- Game file index → Game folder: reads game archives (evidence: `app-tauri/src-tauri/src/game/index.rs`)
- Kit designer → Sider kit-server: exports changes (evidence: `README.md`)
- Rust game core → Sider kit-server: writes kit changes (evidence: `README.md`)
- Game data store → Kit-server files: exports and restores (evidence: `app-tauri/src-tauri/src/store.rs`)
