# kiml42/spacecombatsimulation architecture

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

- Interactive diagram: https://gitdiagram.com/kiml42/spacecombatsimulation
- Repository: https://github.com/kiml42/spacecombatsimulation

## Overview

SCS2D is a browser-based space-combat simulator and ship/fleet design application; the README’s Unity description appears stale relative to the supplied TypeScript app. Users can design ships and fleets, configure and play skirmishes, inspect battles, and run design evolution. The graph preserves those major screens and the simulation, rendering, and storage layers. Edges are limited to routing and source references visible in the excerpts or index; unsampled page internals are not inferred.

Main entry points: [`SCS2D/app/routes.tsx`](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes.tsx) (App Routes), [`SCS2D/sim/blueprint.ts`](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/blueprint.ts) (Ship Blueprints), [`SCS2D/sim/index.ts`](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/index.ts) (Simulation API), [`SCS2D/features/storage/observedStorage.ts`](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/features/storage/observedStorage.ts) (Browser Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_routes["App Routes<br/>[routes.tsx]"]
  node_storage[("Browser Storage<br/>[observedStorage.ts]")]
end

subgraph group_design["Design Tools"]
  node_ship["Ship Designer<br/>[ShipPage.tsx]"]
  node_fleet["Fleet Designer<br/>[FleetPage.tsx]"]
  node_library["Design Library<br/>[LibraryPage.tsx]"]
end

subgraph group_combat["Combat"]
  node_skirmish["Skirmish Setup<br/>[SkirmishPage.tsx]"]
  node_scenario["Skirmish Rules<br/>[skirmish.ts]"]
  node_battle["Battle Screen<br/>[BattlePage.tsx]"]
  node_effects["Effects Viewer<br/>[EffectsPage.tsx]"]
end

subgraph group_evolution["Evolution"]
  node_evolution["Evolution Screen<br/>[EvolutionPage.tsx]"]
  node_mutation["Design Mutation<br/>[mutate.ts]"]
end

subgraph group_core["Simulation Core"]
  node_renderer["Canvas Renderer<br/>[canvas2d.ts]"]
  node_sim["Simulation API<br/>[index.ts]"]
  node_blueprint["Ship Blueprints<br/>[blueprint.ts]"]
  node_modules["Ship Modules<br/>[modules.ts]"]
  node_doctrine["Combat Doctrine<br/>[doctrine.ts]"]
  node_geometry["Shape Geometry<br/>[shape.ts]"]
end

node_user(("User"))

node_user -->|"opens app"| node_routes
node_routes -->|"routes to"| node_ship
node_routes -->|"routes to"| node_fleet
node_routes -->|"routes to"| node_library
node_routes -->|"routes to"| node_skirmish
node_routes -->|"routes to"| node_battle
node_routes -->|"routes to"| node_effects
node_routes -->|"routes to"| node_evolution
node_scenario -->|"imports API"| node_sim
node_mutation -->|"imports API"| node_sim
node_renderer -->|"imports API"| node_sim
node_sim -->|"exports"| node_blueprint
node_blueprint -->|"uses"| node_modules
node_blueprint -->|"uses"| node_doctrine
node_blueprint -->|"uses"| node_geometry
node_storage -.->|"persists browser data"| node_user

click node_routes "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes.tsx"
click node_ship "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/ship/ShipPage.tsx"
click node_fleet "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/fleet/FleetPage.tsx"
click node_library "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/library/LibraryPage.tsx"
click node_storage "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/features/storage/observedStorage.ts"
click node_skirmish "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/skirmish/SkirmishPage.tsx"
click node_scenario "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/scenarios/skirmish.ts"
click node_battle "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/battle/BattlePage.tsx"
click node_effects "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/effects/EffectsPage.tsx"
click node_renderer "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/render/canvas2d.ts"
click node_evolution "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/evolution/EvolutionPage.tsx"
click node_mutation "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/evolution/mutate.ts"
click node_sim "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/index.ts"
click node_blueprint "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/blueprint.ts"
click node_modules "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/modules.ts"
click node_doctrine "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/doctrine.ts"
click node_geometry "https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/shape.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_routes,node_storage,node_user toneBlue
class node_ship,node_fleet,node_library toneAmber
class node_skirmish,node_scenario,node_battle,node_effects toneMint
class node_evolution,node_mutation toneRose
class node_renderer,node_sim,node_blueprint,node_modules,node_doctrine,node_geometry toneIndigo
```

## Components

### Application

- [App Routes](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes.tsx): `SCS2D/app/routes.tsx`
- [Browser Storage](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/features/storage/observedStorage.ts): `SCS2D/features/storage/observedStorage.ts`

### Design Tools

- [Ship Designer](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/ship/ShipPage.tsx): `SCS2D/app/routes/ship/ShipPage.tsx`
- [Fleet Designer](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/fleet/FleetPage.tsx): `SCS2D/app/routes/fleet/FleetPage.tsx`
- [Design Library](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/library/LibraryPage.tsx): `SCS2D/app/routes/library/LibraryPage.tsx`

### Combat

- [Skirmish Setup](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/skirmish/SkirmishPage.tsx): `SCS2D/app/routes/skirmish/SkirmishPage.tsx`
- [Skirmish Rules](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/scenarios/skirmish.ts): `SCS2D/scenarios/skirmish.ts`
- [Battle Screen](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/battle/BattlePage.tsx): `SCS2D/app/routes/battle/BattlePage.tsx`
- [Effects Viewer](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/effects/EffectsPage.tsx): `SCS2D/app/routes/effects/EffectsPage.tsx`

### Evolution

- [Evolution Screen](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/app/routes/evolution/EvolutionPage.tsx): `SCS2D/app/routes/evolution/EvolutionPage.tsx`
- [Design Mutation](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/evolution/mutate.ts): `SCS2D/evolution/mutate.ts`

### Simulation Core

- [Canvas Renderer](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/render/canvas2d.ts): `SCS2D/render/canvas2d.ts`
- [Simulation API](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/index.ts): `SCS2D/sim/index.ts`
- [Ship Blueprints](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/blueprint.ts): `SCS2D/sim/blueprint.ts`
- [Ship Modules](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/modules.ts): `SCS2D/sim/modules.ts`
- [Combat Doctrine](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/doctrine.ts): `SCS2D/sim/doctrine.ts`
- [Shape Geometry](https://github.com/kiml42/spacecombatsimulation/blob/master/SCS2D/sim/shape.ts): `SCS2D/sim/shape.ts`

### Other components

- **User**

## Connections

- User → App Routes: opens app (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Ship Designer: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Fleet Designer: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Design Library: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Skirmish Setup: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Battle Screen: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Effects Viewer: routes to (evidence: `SCS2D/app/routes.tsx`)
- App Routes → Evolution Screen: routes to (evidence: `SCS2D/app/routes.tsx`)
- Skirmish Rules → Simulation API: imports API (evidence: `SCS2D/scenarios/skirmish.ts`)
- Design Mutation → Simulation API: imports API (evidence: `SCS2D/evolution/mutate.ts`)
- Canvas Renderer → Simulation API: imports API (evidence: `SCS2D/render/canvas2d.ts`)
- Simulation API → Ship Blueprints: exports (evidence: `SCS2D/sim/index.ts`)
- Ship Blueprints → Ship Modules: uses (evidence: `SCS2D/sim/blueprint.ts`)
- Ship Blueprints → Combat Doctrine: uses (evidence: `SCS2D/sim/blueprint.ts`)
- Ship Blueprints → Shape Geometry: uses (evidence: `SCS2D/sim/blueprint.ts`)
- Browser Storage → User: persists browser data (evidence: `SCS2D/features/storage/observedStorage.ts`)
