# vengataraaman/cmpcalculator architecture

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

- Interactive diagram: https://gitdiagram.com/vengataraaman/cmpcalculator
- Repository: https://github.com/vengataraaman/cmpcalculator

## Overview

CMPCalculator is a Compose Multiplatform calculator for basic arithmetic. Users enter numbers and operations on the keypad; the screen sends events to a view model, which updates display state and invokes an expression evaluator for live or explicit calculations. Android, iOS, and desktop entry points host the shared UI. The graph covers the sampled shared runtime and documented arithmetic capability; unsampled platform wiring and other implementation details are omitted where their relationships are not shown.

Main entry points: [`composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt`](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt) (Calculator screen), [`composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt`](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt) (Shared app), [`composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt`](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt) (Calculator view model), [`composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt`](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt) (iOS controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platforms["Platform entry points"]
  node_android["Android activity<br/>[MainActivity.kt]"]
  node_ios["iOS host view<br/>[ContentView.swift]"]
  node_ioscontroller["iOS controller"]
  node_desktop["Desktop entry<br/>[main.kt]"]
end

subgraph group_ui["Calculator UI"]
  node_app["Shared app<br/>[App.kt]"]
  node_screen["Calculator screen"]
  node_button["Keypad buttons<br/>[CalcButton.kt]"]
  node_textfields["Display fields<br/>[CalcTextField.kt]"]
end

subgraph group_state["Interaction state"]
  node_viewmodel["Calculator view model"]
  node_calcstate["Calculator state<br/>[CalcState.kt]"]
end

subgraph group_math["Expression evaluation"]
  node_evaluator["Evaluator interface"]
  node_standard["Standard math evaluator"]
end

node_user(("Calculator user"))

node_user -->|"uses"| node_screen
node_android -->|"hosts"| node_app
node_ios -->|"creates"| node_ioscontroller
node_ioscontroller -->|"hosts"| node_app
node_desktop -->|"hosts"| node_app
node_app -->|"renders"| node_screen
node_screen -->|"observes and dispatches"| node_viewmodel
node_screen -->|"renders"| node_button
node_screen -->|"renders"| node_textfields
node_viewmodel -->|"updates"| node_calcstate
node_viewmodel -->|"evaluates through"| node_evaluator
node_standard -->|"implements"| node_evaluator

click node_android "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/androidMain/kotlin/com/vengat/calculator/MainActivity.kt"
click node_ios "https://github.com/vengataraaman/cmpcalculator/blob/main/iosApp/iosApp/ContentView.swift"
click node_ioscontroller "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt"
click node_desktop "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/jvmMain/kotlin/com/vengat/calculator/main.kt"
click node_app "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt"
click node_screen "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt"
click node_button "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcButton.kt"
click node_textfields "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcTextField.kt"
click node_viewmodel "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt"
click node_calcstate "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalcState.kt"
click node_evaluator "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/core/ExpressionEvaluator.kt"
click node_standard "https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/core/StandardMathExpressionEvaluator.kt"

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_android,node_ios,node_ioscontroller,node_desktop,node_user toneBlue
class node_app,node_screen,node_button,node_textfields toneAmber
class node_viewmodel,node_calcstate toneMint
class node_evaluator,node_standard toneRose
```

## Components

### Platform entry points

- [Android activity](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/androidMain/kotlin/com/vengat/calculator/MainActivity.kt): `composeApp/src/androidMain/kotlin/com/vengat/calculator/MainActivity.kt`
- [iOS host view](https://github.com/vengataraaman/cmpcalculator/blob/main/iosApp/iosApp/ContentView.swift): `iosApp/iosApp/ContentView.swift`
- [iOS controller](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt): `composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt`
- [Desktop entry](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/jvmMain/kotlin/com/vengat/calculator/main.kt): `composeApp/src/jvmMain/kotlin/com/vengat/calculator/main.kt`

### Calculator UI

- [Shared app](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt`
- [Calculator screen](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt`
- [Keypad buttons](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcButton.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcButton.kt`
- [Display fields](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcTextField.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/designsystem/CalcTextField.kt`

### Interaction state

- [Calculator view model](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt`
- [Calculator state](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalcState.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalcState.kt`

### Expression evaluation

- [Evaluator interface](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/core/ExpressionEvaluator.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/core/ExpressionEvaluator.kt`
- [Standard math evaluator](https://github.com/vengataraaman/cmpcalculator/blob/main/composeApp/src/commonMain/kotlin/com/vengat/calculator/core/StandardMathExpressionEvaluator.kt): `composeApp/src/commonMain/kotlin/com/vengat/calculator/core/StandardMathExpressionEvaluator.kt`

### Other components

- **Calculator user**

## Connections

- Calculator user → Calculator screen: uses
- Android activity → Shared app: hosts (evidence: `composeApp/src/androidMain/kotlin/com/vengat/calculator/MainActivity.kt`)
- iOS host view → iOS controller: creates (evidence: `iosApp/iosApp/ContentView.swift`)
- iOS controller → Shared app: hosts (evidence: `composeApp/src/iosMain/kotlin/com/vengat/calculator/MainViewController.kt`)
- Desktop entry → Shared app: hosts (evidence: `composeApp/src/jvmMain/kotlin/com/vengat/calculator/main.kt`)
- Shared app → Calculator screen: renders (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/App.kt`)
- Calculator screen → Calculator view model: observes and dispatches (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt`)
- Calculator screen → Keypad buttons: renders (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt`)
- Calculator screen → Display fields: renders (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorScreen.kt`)
- Calculator view model → Calculator state: updates (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt`)
- Calculator view model → Evaluator interface: evaluates through (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/presentation/CalculatorViewModel.kt`)
- Standard math evaluator → Evaluator interface: implements (evidence: `composeApp/src/commonMain/kotlin/com/vengat/calculator/core/StandardMathExpressionEvaluator.kt`)
