# stormwatch/cuis-smalltalk-dev architecture

> Architecture diagram of the GitHub repository stormwatch/cuis-smalltalk-dev, 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/stormwatch/cuis-smalltalk-dev
- Repository: https://github.com/stormwatch/cuis-smalltalk-dev

## Overview

Cuis is a multiplatform Smalltalk-80 system distributed here as an image, a virtual-machine bundle, and packages. The documented user workflow is to obtain the repository and start Cuis; the README does not specify the runtime call chain, so links between those runtime parts are unverified. Update names indicate kernel, Morphic UI, and development-tool capabilities, but source excerpts were unavailable, so their internal relationships are not asserted.

Main entry points: [`CuisImage/32BitsImage`](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisImage/32BitsImage) (Smalltalk image), [`CuisVM.app`](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisVM.app) (Virtual machine), [`Packages/Features`](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/Features) (Feature packages), [`Packages/System`](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/System) (System packages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Cuis runtime"]
  node_image[("Smalltalk image")]
  node_vm["Virtual machine<br/>[CuisVM.app]"]
end

subgraph group_system["System capabilities"]
  node_kernel["Smalltalk kernel"]
  node_morphic["Morphic UI"]
  node_devtools["Development tools"]
end

subgraph group_extensions["Packages and updates"]
  node_features["Feature packages"]
  node_systempackages["System packages"]
  node_compat["Compatibility packages"]
end

node_user(("Cuis user"))

node_user -.->|"starts Cuis"| node_vm
node_vm -.->|"runs image"| node_image
node_features -.->|"extends"| node_image
node_systempackages -.->|"extends"| node_image
node_compat -.->|"adds compatibility"| node_image

click node_image "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisImage/32BitsImage"
click node_vm "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisVM.app"
click node_kernel "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates"
click node_morphic "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates"
click node_devtools "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates"
click node_features "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/Features"
click node_systempackages "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/System"
click node_compat "https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CompatibilityPackages"

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_image,node_vm,node_user toneBlue
class node_kernel,node_morphic,node_devtools toneAmber
class node_features,node_systempackages,node_compat toneMint
```

## Components

### Cuis runtime

- [Smalltalk image](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisImage/32BitsImage): `CuisImage/32BitsImage`
- [Virtual machine](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CuisVM.app): `CuisVM.app`

### System capabilities

- [Smalltalk kernel](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates): `CoreUpdates`
- [Morphic UI](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates): `CoreUpdates`
- [Development tools](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CoreUpdates): `CoreUpdates`

### Packages and updates

- [Feature packages](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/Features): `Packages/Features`
- [System packages](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/Packages/System): `Packages/System`
- [Compatibility packages](https://github.com/stormwatch/cuis-smalltalk-dev/tree/master/CompatibilityPackages): `CompatibilityPackages`

### Other components

- **Cuis user**

## Connections

- Cuis user → Virtual machine: starts Cuis
- Virtual machine → Smalltalk image: runs image
- Feature packages → Smalltalk image: extends
- System packages → Smalltalk image: extends
- Compatibility packages → Smalltalk image: adds compatibility
