# andymutale/hoplite37 architecture

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

- Interactive diagram: https://gitdiagram.com/andymutale/hoplite37
- Repository: https://github.com/andymutale/hoplite37

## Overview

Pickability Check is a browser-based pre-purchase feasibility tool for vision-guided bin picking. The user uploads a CAD part, configures the bin, gripper, robot, grasp orientation and part layout, then receives simulated outcome buckets and a 3D view. WizardShell routes through these stages; the wizard store holds shared inputs and results. The simulation uses Rapier geometric checks and calls inverse kinematics for reachability. The documented workflow and sampled imports support the map; unsampled implementation details are not inferred.

Main entry points: [`src/components/wizard/WizardShell.tsx`](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/WizardShell.tsx) (Wizard shell), [`src/stores/wizardStore.ts`](https://github.com/andymutale/hoplite37/blob/main/src/stores/wizardStore.ts) (Wizard state), [`src/components/wizard/ResultsStep.tsx`](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/ResultsStep.tsx) (Results view), [`src/components/wizard/RobotStep.tsx`](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/RobotStep.tsx) (Robot setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Wizard interface"]
  node_app["Wizard shell<br/>[WizardShell.tsx]"]
end

subgraph group_setup["Pick setup"]
  node_target["CAD target<br/>[TargetStep.tsx]"]
  node_bin["Bin setup<br/>[BinStep.tsx]"]
  node_gripper["Gripper setup<br/>[GripperStep.tsx]"]
  node_robot["Robot setup<br/>[RobotStep.tsx]"]
  node_pick["Pick orientation<br/>[PickPointStep.tsx]"]
  node_layout["Part layout<br/>[LayoutStep.tsx]"]
end

subgraph group_model["Model and state"]
  node_model["CAD model view<br/>[LoadedModel.tsx]"]
  node_viewport["3D viewport<br/>[Viewport.tsx]"]
  node_state["Wizard state<br/>[wizardStore.ts]"]
end

subgraph group_analysis["Simulation and results"]
  node_presets["Robot presets<br/>[robotPresets.ts]"]
  node_ik["Kinematics checks<br/>[ik.ts]"]
  node_simulation["Pickability simulation<br/>[simulation.ts]"]
  node_results["Results view<br/>[ResultsStep.tsx]"]
end

node_user(("Engineer"))

node_user -->|"configures"| node_app
node_app -->|"routes to"| node_target
node_app -->|"routes to"| node_bin
node_app -->|"routes to"| node_gripper
node_app -->|"routes to"| node_robot
node_app -->|"routes to"| node_pick
node_app -->|"routes to"| node_layout
node_app -->|"routes to"| node_results
node_target -->|"loads model"| node_model
node_pick -->|"renders model"| node_model
node_target -->|"updates"| node_state
node_bin -->|"updates"| node_state
node_gripper -->|"updates"| node_state
node_robot -->|"updates"| node_state
node_robot -->|"reads"| node_presets
node_robot -->|"calls"| node_ik
node_pick -->|"updates"| node_state
node_layout -->|"updates"| node_state
node_results -->|"reads inputs"| node_state
node_results -->|"runs"| node_simulation
node_results -->|"reads"| node_presets
node_simulation -->|"checks reachability"| node_ik
node_simulation -->|"uses types"| node_state
node_results -->|"renders results"| node_viewport

click node_app "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/WizardShell.tsx"
click node_target "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/TargetStep.tsx"
click node_bin "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/BinStep.tsx"
click node_gripper "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/GripperStep.tsx"
click node_robot "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/RobotStep.tsx"
click node_pick "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/PickPointStep.tsx"
click node_layout "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/LayoutStep.tsx"
click node_model "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/LoadedModel.tsx"
click node_viewport "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/Viewport.tsx"
click node_state "https://github.com/andymutale/hoplite37/blob/main/src/stores/wizardStore.ts"
click node_presets "https://github.com/andymutale/hoplite37/blob/main/src/data/robotPresets.ts"
click node_ik "https://github.com/andymutale/hoplite37/blob/main/src/lib/ik.ts"
click node_simulation "https://github.com/andymutale/hoplite37/blob/main/src/lib/simulation.ts"
click node_results "https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/ResultsStep.tsx"

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 toneBlue
class node_target,node_bin,node_gripper,node_robot,node_pick,node_layout toneAmber
class node_model,node_viewport,node_state toneMint
class node_presets,node_ik,node_simulation,node_results toneRose
class node_user toneIndigo
```

## Components

### Wizard interface

- [Wizard shell](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/WizardShell.tsx): `src/components/wizard/WizardShell.tsx`

### Pick setup

- [CAD target](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/TargetStep.tsx): `src/components/wizard/TargetStep.tsx`
- [Bin setup](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/BinStep.tsx): `src/components/wizard/BinStep.tsx`
- [Gripper setup](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/GripperStep.tsx): `src/components/wizard/GripperStep.tsx`
- [Robot setup](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/RobotStep.tsx): `src/components/wizard/RobotStep.tsx`
- [Pick orientation](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/PickPointStep.tsx): `src/components/wizard/PickPointStep.tsx`
- [Part layout](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/LayoutStep.tsx): `src/components/wizard/LayoutStep.tsx`

### Model and state

- [CAD model view](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/LoadedModel.tsx): `src/components/wizard/LoadedModel.tsx`
- [3D viewport](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/Viewport.tsx): `src/components/wizard/Viewport.tsx`
- [Wizard state](https://github.com/andymutale/hoplite37/blob/main/src/stores/wizardStore.ts): `src/stores/wizardStore.ts`

### Simulation and results

- [Robot presets](https://github.com/andymutale/hoplite37/blob/main/src/data/robotPresets.ts): `src/data/robotPresets.ts`
- [Kinematics checks](https://github.com/andymutale/hoplite37/blob/main/src/lib/ik.ts): `src/lib/ik.ts`
- [Pickability simulation](https://github.com/andymutale/hoplite37/blob/main/src/lib/simulation.ts): `src/lib/simulation.ts`
- [Results view](https://github.com/andymutale/hoplite37/blob/main/src/components/wizard/ResultsStep.tsx): `src/components/wizard/ResultsStep.tsx`

### Other components

- **Engineer**

## Connections

- Engineer → Wizard shell: configures (evidence: `README.md`)
- Wizard shell → CAD target: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Bin setup: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Gripper setup: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Robot setup: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Pick orientation: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Part layout: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- Wizard shell → Results view: routes to (evidence: `src/components/wizard/WizardShell.tsx`)
- CAD target → CAD model view: loads model (evidence: `src/components/wizard/TargetStep.tsx`)
- Pick orientation → CAD model view: renders model (evidence: `src/components/wizard/PickPointStep.tsx`)
- CAD target → Wizard state: updates (evidence: `src/components/wizard/TargetStep.tsx`)
- Bin setup → Wizard state: updates (evidence: `src/components/wizard/BinStep.tsx`)
- Gripper setup → Wizard state: updates (evidence: `src/components/wizard/GripperStep.tsx`)
- Robot setup → Wizard state: updates (evidence: `src/components/wizard/RobotStep.tsx`)
- Robot setup → Robot presets: reads (evidence: `src/components/wizard/RobotStep.tsx`)
- Robot setup → Kinematics checks: calls (evidence: `src/components/wizard/RobotStep.tsx`)
- Pick orientation → Wizard state: updates (evidence: `src/components/wizard/PickPointStep.tsx`)
- Part layout → Wizard state: updates (evidence: `src/components/wizard/LayoutStep.tsx`)
- Results view → Wizard state: reads inputs (evidence: `src/components/wizard/ResultsStep.tsx`)
- Results view → Pickability simulation: runs (evidence: `src/components/wizard/ResultsStep.tsx`)
- Results view → Robot presets: reads (evidence: `src/components/wizard/ResultsStep.tsx`)
- Pickability simulation → Kinematics checks: checks reachability (evidence: `src/lib/simulation.ts`)
- Pickability simulation → Wizard state: uses types (evidence: `src/lib/simulation.ts`)
- Results view → 3D viewport: renders results (evidence: `src/components/wizard/ResultsStep.tsx`)
