# alpha123/uma-tools architecture

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

- Interactive diagram: https://gitdiagram.com/alpha123/uma-tools
- Repository: https://github.com/alpha123/uma-tools

## Overview

This repository is a collection of Umamusume browser tools: horse/build editing, race simulation, skill and course visualization, and several smaller utilities. A user configures a horse, skills, or course in a tool’s app; the relevant tool then presents a plan, comparison, simulation, or visualization. Shared components provide horse/skill editing, track display, localization, serialization, and state helpers. The excerpts establish several imports and UI compositions; other tool internals and some runtime wiring are unsampled, so uncertain links are omitted or marked unverified.

Main entry points: [`components/HorseDef.tsx`](https://github.com/alpha123/uma-tools/blob/master/components/HorseDef.tsx) (Horse editor), [`umalator/app.tsx`](https://github.com/alpha123/uma-tools/blob/master/umalator/app.tsx) (Race simulator app), [`components/SkillList.tsx`](https://github.com/alpha123/uma-tools/blob/master/components/SkillList.tsx) (Skill list and details), [`components/Language.tsx`](https://github.com/alpha123/uma-tools/blob/master/components/Language.tsx) (Language selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Horse and build planning"]
  node_planner["Build planner<br/>[app.tsx]"]
end

subgraph group_simulation["Race simulation"]
  node_simulator["Race simulator app<br/>[app.tsx]"]
  node_sim_worker["Simulation worker"]
  node_race_compare["Race comparison logic<br/>[compare.ts]"]
  node_hp_calc["HP calculations<br/>[hpcalc.ts]"]
  node_basinn_chart["Skill basin chart<br/>[BasinnChart.tsx]"]
  node_stamina_calc["Stamina calculator<br/>[StaCalc.tsx]"]
  node_intro_text["Simulator introduction<br/>[IntroText.tsx]"]
end

subgraph group_analysis["Skill and course analysis"]
  node_skill_visualizer["Skill visualizer<br/>[app.tsx]"]
  node_course_images["Course images<br/>[app.tsx]"]
end

subgraph group_shared["Shared domain components"]
  node_horse_editor["Horse editor<br/>[HorseDef.tsx]"]
  node_horse_types["Horse data model<br/>[HorseDefTypes.ts]"]
  node_ocr_ui["Horse OCR<br/>[HorseOcr.tsx]"]
  node_save_manager["Horse save manager<br/>[HorseSaveMngr.tsx]"]
  node_score_calc["Score calculator<br/>[scorecalc.ts]"]
  node_skill_list["Skill list and details<br/>[SkillList.tsx]"]
  node_language["Language selection<br/>[Language.tsx]"]
  node_race_track["Track display and selection<br/>[RaceTrack.tsx]"]
  node_state_lenses["State lenses<br/>[optics.ts]"]
  node_translations["Common strings<br/>[common.ts]"]
  node_autocomplete["Autocomplete<br/>[autocomplete.jsx]"]
  node_ocr_engine["OCR helpers<br/>[ocr.ts]"]
end

subgraph group_utilities["Other utilities"]
  node_sorter["Skill sorter<br/>[app.tsx]"]
  node_sort_logic["Sort logic<br/>[sort.ts]"]
  node_umadle["Umadle game<br/>[app.tsx]"]
  node_rougelike["Rougelike tool<br/>[app.tsx]"]
  node_color_conversion["Color conversion<br/>[colorconversion.js]"]
end

node_user(("Tool user"))

node_user -->|"configures"| node_planner
node_planner -->|"renders"| node_horse_editor
node_planner -->|"uses state"| node_state_lenses
node_planner -->|"uses language"| node_language
node_user -.->|"configures"| node_simulator
node_simulator -->|"renders details"| node_skill_list
node_simulator -->|"serializes horse"| node_horse_types
node_simulator -->|"renders chart"| node_basinn_chart
node_simulator -.->|"uses calculator"| node_stamina_calc
node_simulator -.->|"renders text"| node_intro_text
node_sim_worker -->|"uses comparison"| node_race_compare
node_sim_worker -->|"uses calculations"| node_hp_calc
node_race_compare -->|"uses horse types"| node_horse_types
node_hp_calc -->|"uses comparison"| node_race_compare
node_user -->|"selects skills"| node_skill_visualizer
node_skill_visualizer -->|"renders details"| node_skill_list
node_skill_visualizer -->|"renders track"| node_race_track
node_skill_visualizer -->|"uses language"| node_language
node_user -.->|"browses courses"| node_course_images
node_course_images -->|"uses track UI"| node_race_track
node_user -.->|"sorts skills"| node_sorter
node_sorter -->|"uses sorting"| node_sort_logic
node_user -.->|"plays"| node_umadle
node_user -.->|"uses tool"| node_rougelike
node_rougelike -->|"uses conversion"| node_color_conversion
node_horse_editor -->|"serializes horse"| node_horse_types
node_horse_editor -.->|"integrates OCR"| node_ocr_ui
node_horse_editor -.->|"integrates saves"| node_save_manager
node_horse_editor -.->|"uses scoring"| node_score_calc
node_horse_editor -->|"uses language"| node_language
node_horse_editor -->|"uses skills"| node_skill_list
node_ocr_ui -->|"uses OCR"| node_ocr_engine
node_skill_list -->|"uses language"| node_language
node_skill_list -.->|"uses input"| node_autocomplete
node_race_track -->|"uses language"| node_language
node_translations -.->|"labels UI"| node_user

click node_planner "https://github.com/alpha123/uma-tools/blob/master/build-planner/app.tsx"
click node_horse_editor "https://github.com/alpha123/uma-tools/blob/master/components/HorseDef.tsx"
click node_horse_types "https://github.com/alpha123/uma-tools/blob/master/components/HorseDefTypes.ts"
click node_ocr_ui "https://github.com/alpha123/uma-tools/blob/master/components/HorseOcr.tsx"
click node_save_manager "https://github.com/alpha123/uma-tools/blob/master/components/HorseSaveMngr.tsx"
click node_score_calc "https://github.com/alpha123/uma-tools/blob/master/components/scorecalc.ts"
click node_skill_list "https://github.com/alpha123/uma-tools/blob/master/components/SkillList.tsx"
click node_language "https://github.com/alpha123/uma-tools/blob/master/components/Language.tsx"
click node_race_track "https://github.com/alpha123/uma-tools/blob/master/components/RaceTrack.tsx"
click node_state_lenses "https://github.com/alpha123/uma-tools/blob/master/optics.ts"
click node_translations "https://github.com/alpha123/uma-tools/blob/master/strings/common.ts"
click node_simulator "https://github.com/alpha123/uma-tools/blob/master/umalator/app.tsx"
click node_sim_worker "https://github.com/alpha123/uma-tools/blob/master/umalator/simulator.worker.ts"
click node_race_compare "https://github.com/alpha123/uma-tools/blob/master/umalator/compare.ts"
click node_hp_calc "https://github.com/alpha123/uma-tools/blob/master/umalator/hpcalc.ts"
click node_basinn_chart "https://github.com/alpha123/uma-tools/blob/master/umalator/BasinnChart.tsx"
click node_stamina_calc "https://github.com/alpha123/uma-tools/blob/master/umalator/StaCalc.tsx"
click node_intro_text "https://github.com/alpha123/uma-tools/blob/master/umalator/IntroText.tsx"
click node_skill_visualizer "https://github.com/alpha123/uma-tools/blob/master/skill-visualizer/app.tsx"
click node_course_images "https://github.com/alpha123/uma-tools/blob/master/courseimages/app.tsx"
click node_sorter "https://github.com/alpha123/uma-tools/blob/master/sorter/app.tsx"
click node_sort_logic "https://github.com/alpha123/uma-tools/blob/master/sorter/sort.ts"
click node_umadle "https://github.com/alpha123/uma-tools/blob/master/umadle/app.tsx"
click node_rougelike "https://github.com/alpha123/uma-tools/blob/master/rougelike/app.tsx"
click node_color_conversion "https://github.com/alpha123/uma-tools/blob/master/rougelike/colorconversion.js"
click node_autocomplete "https://github.com/alpha123/uma-tools/blob/master/components/autocomplete.jsx"
click node_ocr_engine "https://github.com/alpha123/uma-tools/blob/master/components/ocr.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_planner,node_user toneBlue
class node_simulator,node_sim_worker,node_race_compare,node_hp_calc,node_basinn_chart,node_stamina_calc,node_intro_text toneAmber
class node_skill_visualizer,node_course_images toneMint
class node_horse_editor,node_horse_types,node_ocr_ui,node_save_manager,node_score_calc,node_skill_list,node_language,node_race_track,node_state_lenses,node_translations,node_autocomplete,node_ocr_engine toneRose
class node_sorter,node_sort_logic,node_umadle,node_rougelike,node_color_conversion toneIndigo
```

## Components

### Horse and build planning

- [Build planner](https://github.com/alpha123/uma-tools/blob/master/build-planner/app.tsx): `build-planner/app.tsx`

### Race simulation

- [Race simulator app](https://github.com/alpha123/uma-tools/blob/master/umalator/app.tsx): `umalator/app.tsx`
- [Simulation worker](https://github.com/alpha123/uma-tools/blob/master/umalator/simulator.worker.ts): `umalator/simulator.worker.ts`
- [Race comparison logic](https://github.com/alpha123/uma-tools/blob/master/umalator/compare.ts): `umalator/compare.ts`
- [HP calculations](https://github.com/alpha123/uma-tools/blob/master/umalator/hpcalc.ts): `umalator/hpcalc.ts`
- [Skill basin chart](https://github.com/alpha123/uma-tools/blob/master/umalator/BasinnChart.tsx): `umalator/BasinnChart.tsx`
- [Stamina calculator](https://github.com/alpha123/uma-tools/blob/master/umalator/StaCalc.tsx): `umalator/StaCalc.tsx`
- [Simulator introduction](https://github.com/alpha123/uma-tools/blob/master/umalator/IntroText.tsx): `umalator/IntroText.tsx`

### Skill and course analysis

- [Skill visualizer](https://github.com/alpha123/uma-tools/blob/master/skill-visualizer/app.tsx): `skill-visualizer/app.tsx`
- [Course images](https://github.com/alpha123/uma-tools/blob/master/courseimages/app.tsx): `courseimages/app.tsx`

### Shared domain components

- [Horse editor](https://github.com/alpha123/uma-tools/blob/master/components/HorseDef.tsx): `components/HorseDef.tsx`
- [Horse data model](https://github.com/alpha123/uma-tools/blob/master/components/HorseDefTypes.ts): `components/HorseDefTypes.ts`
- [Horse OCR](https://github.com/alpha123/uma-tools/blob/master/components/HorseOcr.tsx): `components/HorseOcr.tsx`
- [Horse save manager](https://github.com/alpha123/uma-tools/blob/master/components/HorseSaveMngr.tsx): `components/HorseSaveMngr.tsx`
- [Score calculator](https://github.com/alpha123/uma-tools/blob/master/components/scorecalc.ts): `components/scorecalc.ts`
- [Skill list and details](https://github.com/alpha123/uma-tools/blob/master/components/SkillList.tsx): `components/SkillList.tsx`
- [Language selection](https://github.com/alpha123/uma-tools/blob/master/components/Language.tsx): `components/Language.tsx`
- [Track display and selection](https://github.com/alpha123/uma-tools/blob/master/components/RaceTrack.tsx): `components/RaceTrack.tsx`
- [State lenses](https://github.com/alpha123/uma-tools/blob/master/optics.ts): `optics.ts`
- [Common strings](https://github.com/alpha123/uma-tools/blob/master/strings/common.ts): `strings/common.ts`
- [Autocomplete](https://github.com/alpha123/uma-tools/blob/master/components/autocomplete.jsx): `components/autocomplete.jsx`
- [OCR helpers](https://github.com/alpha123/uma-tools/blob/master/components/ocr.ts): `components/ocr.ts`

### Other utilities

- [Skill sorter](https://github.com/alpha123/uma-tools/blob/master/sorter/app.tsx): `sorter/app.tsx`
- [Sort logic](https://github.com/alpha123/uma-tools/blob/master/sorter/sort.ts): `sorter/sort.ts`
- [Umadle game](https://github.com/alpha123/uma-tools/blob/master/umadle/app.tsx): `umadle/app.tsx`
- [Rougelike tool](https://github.com/alpha123/uma-tools/blob/master/rougelike/app.tsx): `rougelike/app.tsx`
- [Color conversion](https://github.com/alpha123/uma-tools/blob/master/rougelike/colorconversion.js): `rougelike/colorconversion.js`

### Other components

- **Tool user**

## Connections

- Tool user → Build planner: configures (evidence: `build-planner/app.tsx`)
- Build planner → Horse editor: renders (evidence: `build-planner/app.tsx`)
- Build planner → State lenses: uses state (evidence: `build-planner/app.tsx`)
- Build planner → Language selection: uses language (evidence: `build-planner/app.tsx`)
- Tool user → Race simulator app: configures
- Race simulator app → Skill list and details: renders details (evidence: `umalator/app.tsx`)
- Race simulator app → Horse data model: serializes horse (evidence: `umalator/app.tsx`)
- Race simulator app → Skill basin chart: renders chart (evidence: `umalator/app.tsx`)
- Race simulator app → Stamina calculator: uses calculator (evidence: `umalator/app.tsx`)
- Race simulator app → Simulator introduction: renders text (evidence: `umalator/app.tsx`)
- Simulation worker → Race comparison logic: uses comparison (evidence: `umalator/simulator.worker.ts`)
- Simulation worker → HP calculations: uses calculations (evidence: `umalator/simulator.worker.ts`)
- Race comparison logic → Horse data model: uses horse types (evidence: `umalator/compare.ts`)
- HP calculations → Race comparison logic: uses comparison (evidence: `umalator/hpcalc.ts`)
- Tool user → Skill visualizer: selects skills (evidence: `skill-visualizer/app.tsx`)
- Skill visualizer → Skill list and details: renders details (evidence: `skill-visualizer/app.tsx`)
- Skill visualizer → Track display and selection: renders track (evidence: `skill-visualizer/app.tsx`)
- Skill visualizer → Language selection: uses language (evidence: `skill-visualizer/app.tsx`)
- Tool user → Course images: browses courses
- Course images → Track display and selection: uses track UI (evidence: `courseimages/app.tsx`)
- Tool user → Skill sorter: sorts skills
- Skill sorter → Sort logic: uses sorting (evidence: `sorter/app.tsx`)
- Tool user → Umadle game: plays
- Tool user → Rougelike tool: uses tool
- Rougelike tool → Color conversion: uses conversion (evidence: `rougelike/app.tsx`)
- Horse editor → Horse data model: serializes horse (evidence: `components/HorseDef.tsx`)
- Horse editor → Horse OCR: integrates OCR (evidence: `components/HorseDef.tsx`)
- Horse editor → Horse save manager: integrates saves (evidence: `components/HorseDef.tsx`)
- Horse editor → Score calculator: uses scoring (evidence: `components/HorseDef.tsx`)
- Horse editor → Language selection: uses language (evidence: `components/HorseDef.tsx`)
- Horse editor → Skill list and details: uses skills (evidence: `components/HorseDef.tsx`)
- Horse OCR → OCR helpers: uses OCR (evidence: `components/HorseOcr.tsx`)
- Skill list and details → Language selection: uses language (evidence: `components/SkillList.tsx`)
- Skill list and details → Autocomplete: uses input
- Track display and selection → Language selection: uses language (evidence: `components/RaceTrack.tsx`)
- Common strings → Tool user: labels UI
