# microsoft/calculator architecture

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

- Interactive diagram: https://gitdiagram.com/microsoft/calculator
- Repository: https://github.com/microsoft/calculator

## Overview

Windows Calculator is a multi-mode calculator app: users enter calculations or choose a feature, and the app presents results through its Windows UI. The documented modes include standard, scientific, programmer, date, and graphing; other major capabilities are history, memory, unit conversion, and currency conversion. The sampled native code shows the interop wrapper creating the manager, which selects and drives calculation engines and reports display callbacks. The tree and README establish additional feature areas, but their internal call wiring was not sampled, so those links are kept conservative.

Main entry points: [`src/CalcManager/CalculatorManager.cpp`](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CalculatorManager.cpp) (Calculator manager), [`src/CalcManager.Interop/CalcManagerImpl.cpp`](https://github.com/microsoft/calculator/blob/main/src/CalcManager.Interop/CalcManagerImpl.cpp) (Manager interop), [`src/Calculator/App.xaml.cs`](https://github.com/microsoft/calculator/blob/main/src/Calculator/App.xaml.cs) (App launch), [`src/CalcManager/CEngine/calc.cpp`](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CEngine/calc.cpp) (Calculation engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_app["App launch<br/>[App.xaml.cs]"]
  node_mainpage["Main page<br/>[MainPage.xaml.cs]"]
  node_calcview["Calculator views<br/>[Calculator.xaml.cs]"]
end

subgraph group_native["Calculation core"]
  node_wrapper["Manager interop"]
  node_manager["Calculator manager"]
  node_engine["Calculation engine<br/>[calc.cpp]"]
  node_rational["Rational arithmetic<br/>[RationalMath.cpp]"]
  node_history["Calculation history"]
  node_resources["Engine resources"]
  node_resourcebridge["Resource bridge"]
end

subgraph group_features["Calculator features"]
  node_stdvm["Standard calculator"]
  node_datevm["Date calculator"]
  node_unitvm["Unit converter"]
  node_graphvm["Graphing calculator"]
  node_historyvm["History and memory"]
end

subgraph group_services["Data and graph services"]
  node_unitdata["Unit data loader"]
  node_currencydata["Currency data loader"]
  node_currencyhttp["Currency HTTP client"]
  node_graphcontrol["Graph control<br/>[Grapher.cpp]"]
  node_graphapi["Graphing API<br/>[IGraph.h]"]
  node_graphmock["Mock graph engine<br/>[MathSolver.cpp]"]
end

node_user(("User"))
node_bing["Bing currency data"]

node_user -->|"launches"| node_app
node_app -->|"navigates"| node_mainpage
node_wrapper -->|"creates"| node_manager
node_manager -->|"drives"| node_engine
node_engine -->|"uses arithmetic"| node_rational
node_manager -->|"uses history"| node_history
node_manager -->|"reports display"| node_wrapper
node_wrapper -->|"creates"| node_resourcebridge
node_resourcebridge -->|"requests strings"| node_resources
node_currencydata -->|"uses client"| node_currencyhttp
node_currencyhttp -.->|"fetches rates"| node_bing
node_graphcontrol -->|"uses interface"| node_graphapi
node_graphmock -.->|"implements API"| node_graphapi

click node_app "https://github.com/microsoft/calculator/blob/main/src/Calculator/App.xaml.cs"
click node_mainpage "https://github.com/microsoft/calculator/blob/main/src/Calculator/Views/MainPage.xaml.cs"
click node_calcview "https://github.com/microsoft/calculator/blob/main/src/Calculator/Views/Calculator.xaml.cs"
click node_stdvm "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/StandardCalculatorViewModel.cs"
click node_datevm "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DateCalculatorViewModel.cs"
click node_unitvm "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/UnitConverterViewModel.cs"
click node_graphvm "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/GraphingCalculator/GraphingCalculatorViewModel.cs"
click node_historyvm "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/HistoryViewModel.cs"
click node_wrapper "https://github.com/microsoft/calculator/blob/main/src/CalcManager.Interop/CalcManagerImpl.cpp"
click node_manager "https://github.com/microsoft/calculator/blob/main/src/CalcManager/CalculatorManager.cpp"
click node_engine "https://github.com/microsoft/calculator/blob/main/src/CalcManager/CEngine/calc.cpp"
click node_rational "https://github.com/microsoft/calculator/blob/main/src/CalcManager/CEngine/RationalMath.cpp"
click node_history "https://github.com/microsoft/calculator/blob/main/src/CalcManager/CalculatorHistory.cpp"
click node_unitdata "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/UnitConverterDataLoader.cs"
click node_currencydata "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/CurrencyDataLoader.cs"
click node_currencyhttp "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/CurrencyHttpClient.cs"
click node_graphcontrol "https://github.com/microsoft/calculator/blob/main/src/GraphControl/Control/Grapher.cpp"
click node_graphapi "https://github.com/microsoft/calculator/blob/main/src/GraphingInterfaces/IGraph.h"
click node_graphmock "https://github.com/microsoft/calculator/blob/main/src/GraphingImpl/Mocks/MathSolver.cpp"
click node_resources "https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/Common/EngineResourceProvider.cs"
click node_resourcebridge "https://github.com/microsoft/calculator/blob/main/src/CalcManager.Interop/CalcManagerImpl.cpp"

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,node_mainpage,node_calcview,node_user toneBlue
class node_wrapper,node_manager,node_engine,node_rational,node_history,node_resources,node_resourcebridge toneAmber
class node_stdvm,node_datevm,node_unitvm,node_graphvm,node_historyvm toneMint
class node_unitdata,node_currencydata,node_currencyhttp,node_graphcontrol,node_graphapi,node_graphmock toneRose
class node_bing toneIndigo
```

## Components

### App and UI

- [App launch](https://github.com/microsoft/calculator/blob/main/src/Calculator/App.xaml.cs): `src/Calculator/App.xaml.cs`
- [Main page](https://github.com/microsoft/calculator/blob/main/src/Calculator/Views/MainPage.xaml.cs): `src/Calculator/Views/MainPage.xaml.cs`
- [Calculator views](https://github.com/microsoft/calculator/blob/main/src/Calculator/Views/Calculator.xaml.cs): `src/Calculator/Views/Calculator.xaml.cs`

### Calculation core

- [Manager interop](https://github.com/microsoft/calculator/blob/main/src/CalcManager.Interop/CalcManagerImpl.cpp): `src/CalcManager.Interop/CalcManagerImpl.cpp`
- [Calculator manager](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CalculatorManager.cpp): `src/CalcManager/CalculatorManager.cpp`
- [Calculation engine](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CEngine/calc.cpp): `src/CalcManager/CEngine/calc.cpp`
- [Rational arithmetic](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CEngine/RationalMath.cpp): `src/CalcManager/CEngine/RationalMath.cpp`
- [Calculation history](https://github.com/microsoft/calculator/blob/main/src/CalcManager/CalculatorHistory.cpp): `src/CalcManager/CalculatorHistory.cpp`
- [Engine resources](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/Common/EngineResourceProvider.cs): `src/Calculator.ViewModels/Common/EngineResourceProvider.cs`
- [Resource bridge](https://github.com/microsoft/calculator/blob/main/src/CalcManager.Interop/CalcManagerImpl.cpp): `src/CalcManager.Interop/CalcManagerImpl.cpp`

### Calculator features

- [Standard calculator](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/StandardCalculatorViewModel.cs): `src/Calculator.ViewModels/StandardCalculatorViewModel.cs`
- [Date calculator](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DateCalculatorViewModel.cs): `src/Calculator.ViewModels/DateCalculatorViewModel.cs`
- [Unit converter](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/UnitConverterViewModel.cs): `src/Calculator.ViewModels/UnitConverterViewModel.cs`
- [Graphing calculator](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/GraphingCalculator/GraphingCalculatorViewModel.cs): `src/Calculator.ViewModels/GraphingCalculator/GraphingCalculatorViewModel.cs`
- [History and memory](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/HistoryViewModel.cs): `src/Calculator.ViewModels/HistoryViewModel.cs`

### Data and graph services

- [Unit data loader](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/UnitConverterDataLoader.cs): `src/Calculator.ViewModels/DataLoaders/UnitConverterDataLoader.cs`
- [Currency data loader](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/CurrencyDataLoader.cs): `src/Calculator.ViewModels/DataLoaders/CurrencyDataLoader.cs`
- [Currency HTTP client](https://github.com/microsoft/calculator/blob/main/src/Calculator.ViewModels/DataLoaders/CurrencyHttpClient.cs): `src/Calculator.ViewModels/DataLoaders/CurrencyHttpClient.cs`
- [Graph control](https://github.com/microsoft/calculator/blob/main/src/GraphControl/Control/Grapher.cpp): `src/GraphControl/Control/Grapher.cpp`
- [Graphing API](https://github.com/microsoft/calculator/blob/main/src/GraphingInterfaces/IGraph.h): `src/GraphingInterfaces/IGraph.h`
- [Mock graph engine](https://github.com/microsoft/calculator/blob/main/src/GraphingImpl/Mocks/MathSolver.cpp): `src/GraphingImpl/Mocks/MathSolver.cpp`

### Other components

- **User**
- **Bing currency data**

## Connections

- User → App launch: launches
- App launch → Main page: navigates
- Manager interop → Calculator manager: creates
- Calculator manager → Calculation engine: drives
- Calculation engine → Rational arithmetic: uses arithmetic
- Calculator manager → Calculation history: uses history
- Calculator manager → Manager interop: reports display
- Manager interop → Resource bridge: creates
- Resource bridge → Engine resources: requests strings
- Currency data loader → Currency HTTP client: uses client
- Currency HTTP client → Bing currency data: fetches rates
- Graph control → Graphing API: uses interface
- Mock graph engine → Graphing API: implements API
