# dharanisaravanan0607-code/calculator architecture

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

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

## Overview

Dharani’s Calculator is an Android calculator app. Its apparent user flow is entering expressions through the calculator or scientific keypad, viewing results, and consulting saved calculation history; settings and sound/haptic feedback are supporting capabilities. The tree also shows a ViewModel, calculation engine, and Room-style persistence components. No README or application source excerpts were provided, so the runtime connections below are plausible but unverified; dashed edges mark that evidence limit.

Main entry points: [`app/src/main/java/com/example/ui/CalculatorScreen.kt`](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorScreen.kt) (Calculator screen), [`app/src/main/java/com/example/ui/CalculatorViewModel.kt`](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorViewModel.kt) (Calculator ViewModel), [`app/src/main/java/com/example/ui/components/CalculatorKeypad.kt`](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalculatorKeypad.kt) (Calculator keypad), [`app/src/main/java/com/example/data/CalculatorRepository.kt`](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/CalculatorRepository.kt) (Calculator repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Calculator UI"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_screen["Calculator screen"]
  node_viewmodel["Calculator ViewModel"]
  node_state["UI state"]
  node_display["Calculator display"]
  node_keypad["Calculator keypad"]
  node_scientific["Scientific keypad"]
  node_button["Calc button<br/>[CalcButton.kt]"]
  node_historysheet["History sheet"]
  node_settings["Settings sheet"]
  node_header["Dharani header<br/>[DharaniHeader.kt]"]
end

subgraph group_calculation["Calculation"]
  node_engine["Calculator engine"]
end

subgraph group_storage["History Storage"]
  node_repository["Calculator repository"]
  node_database[("App database<br/>[AppDatabase.kt]")]
  node_dao["History DAO<br/>[HistoryDao.kt]"]
  node_entity["History entity<br/>[HistoryEntity.kt]"]
end

subgraph group_support["App Support"]
  node_feedback["Sound and haptics"]
  node_theme["UI theme"]
end

node_user(("Calculator user"))

node_user -.->|"opens"| node_activity
node_activity -.->|"shows"| node_screen
node_screen -.->|"uses"| node_viewmodel
node_screen -.->|"renders"| node_display
node_screen -.->|"renders"| node_keypad
node_screen -.->|"renders"| node_scientific
node_screen -.->|"shows"| node_historysheet
node_screen -.->|"shows"| node_settings
node_screen -.->|"renders"| node_header
node_keypad -.->|"uses"| node_button
node_scientific -.->|"uses"| node_button
node_viewmodel -.->|"updates"| node_state
node_viewmodel -.->|"evaluates"| node_engine
node_viewmodel -.->|"accesses history"| node_repository
node_repository -.->|"uses"| node_database
node_repository -.->|"accesses"| node_dao
node_dao -.->|"stores"| node_entity
node_keypad -.->|"triggers"| node_feedback
node_screen -.->|"uses"| node_theme

click node_activity "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_screen "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorScreen.kt"
click node_viewmodel "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorViewModel.kt"
click node_state "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorUiState.kt"
click node_display "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalculatorDisplay.kt"
click node_keypad "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalculatorKeypad.kt"
click node_scientific "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/ScientificKeypad.kt"
click node_button "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalcButton.kt"
click node_historysheet "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/HistoryBottomSheet.kt"
click node_settings "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/SettingsBottomSheet.kt"
click node_header "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/DharaniHeader.kt"
click node_engine "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/logic/CalculatorEngine.kt"
click node_repository "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/CalculatorRepository.kt"
click node_database "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/AppDatabase.kt"
click node_dao "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/HistoryDao.kt"
click node_entity "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/HistoryEntity.kt"
click node_feedback "https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/util/SoundHapticHelper.kt"
click node_theme "https://github.com/dharanisaravanan0607-code/calculator/tree/main/app/src/main/java/com/example/ui/theme"

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_activity,node_screen,node_viewmodel,node_state,node_display,node_keypad,node_scientific,node_button,node_historysheet,node_settings,node_header,node_user toneBlue
class node_engine toneAmber
class node_repository,node_database,node_dao,node_entity toneMint
class node_feedback,node_theme toneRose
```

## Components

### Calculator UI

- [Main activity](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [Calculator screen](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorScreen.kt): `app/src/main/java/com/example/ui/CalculatorScreen.kt`
- [Calculator ViewModel](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorViewModel.kt): `app/src/main/java/com/example/ui/CalculatorViewModel.kt`
- [UI state](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/CalculatorUiState.kt): `app/src/main/java/com/example/ui/CalculatorUiState.kt`
- [Calculator display](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalculatorDisplay.kt): `app/src/main/java/com/example/ui/components/CalculatorDisplay.kt`
- [Calculator keypad](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalculatorKeypad.kt): `app/src/main/java/com/example/ui/components/CalculatorKeypad.kt`
- [Scientific keypad](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/ScientificKeypad.kt): `app/src/main/java/com/example/ui/components/ScientificKeypad.kt`
- [Calc button](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/CalcButton.kt): `app/src/main/java/com/example/ui/components/CalcButton.kt`
- [History sheet](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/HistoryBottomSheet.kt): `app/src/main/java/com/example/ui/components/HistoryBottomSheet.kt`
- [Settings sheet](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/SettingsBottomSheet.kt): `app/src/main/java/com/example/ui/components/SettingsBottomSheet.kt`
- [Dharani header](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/ui/components/DharaniHeader.kt): `app/src/main/java/com/example/ui/components/DharaniHeader.kt`

### Calculation

- [Calculator engine](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/logic/CalculatorEngine.kt): `app/src/main/java/com/example/logic/CalculatorEngine.kt`

### History Storage

- [Calculator repository](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/CalculatorRepository.kt): `app/src/main/java/com/example/data/CalculatorRepository.kt`
- [App database](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/AppDatabase.kt): `app/src/main/java/com/example/data/AppDatabase.kt`
- [History DAO](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/HistoryDao.kt): `app/src/main/java/com/example/data/HistoryDao.kt`
- [History entity](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/data/HistoryEntity.kt): `app/src/main/java/com/example/data/HistoryEntity.kt`

### App Support

- [Sound and haptics](https://github.com/dharanisaravanan0607-code/calculator/blob/main/app/src/main/java/com/example/util/SoundHapticHelper.kt): `app/src/main/java/com/example/util/SoundHapticHelper.kt`
- [UI theme](https://github.com/dharanisaravanan0607-code/calculator/tree/main/app/src/main/java/com/example/ui/theme): `app/src/main/java/com/example/ui/theme`

### Other components

- **Calculator user**

## Connections

- Calculator user → Main activity: opens
- Main activity → Calculator screen: shows
- Calculator screen → Calculator ViewModel: uses
- Calculator screen → Calculator display: renders
- Calculator screen → Calculator keypad: renders
- Calculator screen → Scientific keypad: renders
- Calculator screen → History sheet: shows
- Calculator screen → Settings sheet: shows
- Calculator screen → Dharani header: renders
- Calculator keypad → Calc button: uses
- Scientific keypad → Calc button: uses
- Calculator ViewModel → UI state: updates
- Calculator ViewModel → Calculator engine: evaluates
- Calculator ViewModel → Calculator repository: accesses history
- Calculator repository → App database: uses
- Calculator repository → History DAO: accesses
- History DAO → History entity: stores
- Calculator keypad → Sound and haptics: triggers
- Calculator screen → UI theme: uses
