# geogebra/geogebra architecture

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

- Interactive diagram: https://gitdiagram.com/geogebra/geogebra
- Repository: https://github.com/geogebra/geogebra

## Overview

GeoGebra is a suite of interactive mathematics apps, with web and desktop versions. The main user workflow is to interact with a view using math tools, create or edit mathematical objects, and see the construction represented in the app. The source index also supports distinct kernel, construction, spreadsheet, and material-service components. The excerpts show only limited direct runtime wiring, so unverified links are dashed with null evidence; unsampled subsystems are represented only where the tree or README establishes their presence.

Main entry points: [`source/shared/common/src/main/java/org/geogebra/common/main/App.java`](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/App.java) (App core), [`source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java`](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java) (Math kernel), [`source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java`](https://github.com/geogebra/geogebra/blob/main/source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java) (Web app), [`source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java`](https://github.com/geogebra/geogebra/blob/main/source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java) (Desktop app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Interaction and views"]
  node_web["Web app<br/>[GuiManagerW.java]"]
  node_desktop["Desktop app<br/>[GuiManagerD.java]"]
  node_controller["2D interaction"]
  node_view["Euclidian view<br/>[EuclidianView.java]"]
  node_toolset["Math tools"]
end

subgraph group_math["Mathematics engine"]
  node_kernel["Math kernel<br/>[Kernel.java]"]
  node_construction["Construction model<br/>[Construction.java]"]
  node_objects["Math objects<br/>[GeoElement.java]"]
  node_equation["Equation expressions<br/>[Equation.java]"]
  node_expression["Expression trees"]
  node_algorithms["Construction algorithms<br/>[AlgoElement.java]"]
  node_geometry3d["3D geometry<br/>[Manager3D.java]"]
end

subgraph group_apps["App capabilities"]
  node_appcore["App core<br/>[App.java]"]
  node_spreadsheet["Spreadsheet editing"]
  node_spreadsheetcore["Cell drag paste"]
  node_gui["Shared app UI<br/>[GuiManager.java]"]
end

subgraph group_services["Services and state"]
  node_materials["Material service<br/>[MowService.java]"]
  node_materialdata["Material data<br/>[Material.java]"]
  node_exam["Exam storage<br/>[TempStorage.java]"]
  node_undo["Undo history<br/>[UndoManager.java]"]
  node_selection["Selection state"]
  node_scripts["Scripting<br/>[ScriptManager.java]"]
  node_restrictions["App restrictions"]
  node_notation["Engineering notation"]
  node_stringutil["String utilities<br/>[StringUtil.java]"]
end

node_user(("App user"))

node_user -.->|"uses"| node_web
node_user -.->|"uses"| node_desktop
node_web -.->|"hosts"| node_appcore
node_desktop -.->|"hosts"| node_appcore
node_controller -.->|"interacts with"| node_view
node_toolset -.->|"selects modes"| node_controller
node_kernel -.->|"manages"| node_construction
node_construction -.->|"tracks"| node_objects
node_objects -->|"updates"| node_algorithms
node_kernel -.->|"evaluates"| node_expression
node_kernel -.->|"evaluates"| node_equation
node_kernel -.->|"supports"| node_geometry3d
node_spreadsheet -->|"uses"| node_spreadsheetcore
node_appcore -.->|"tracks changes"| node_undo
node_appcore -.->|"manages selection"| node_selection
node_appcore -.->|"supports scripts"| node_scripts
node_appcore -.->|"applies limits"| node_restrictions
node_materials -->|"uses"| node_materialdata
node_exam -->|"uses"| node_materialdata
node_kernel -.->|"formats values"| node_notation
node_appcore -.->|"uses"| node_stringutil

click node_web "https://github.com/geogebra/geogebra/blob/main/source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java"
click node_desktop "https://github.com/geogebra/geogebra/blob/main/source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java"
click node_controller "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianController.java"
click node_view "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianView.java"
click node_toolset "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianConstants.java"
click node_appcore "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/App.java"
click node_kernel "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java"
click node_construction "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/Construction.java"
click node_objects "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/geos/GeoElement.java"
click node_equation "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/Equation.java"
click node_expression "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/ExpressionNode.java"
click node_algorithms "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/algos/AlgoElement.java"
click node_geometry3d "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/geogebra3D/kernel3D/algos/Manager3D.java"
click node_spreadsheet "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/spreadsheet/kernel/KernelCellDragPasteHandler.java"
click node_spreadsheetcore "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/spreadsheet/core/CellDragPasteHandler.java"
click node_gui "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/gui/GuiManager.java"
click node_materials "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/MowService.java"
click node_materialdata "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/Material.java"
click node_exam "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/exam/TempStorage.java"
click node_undo "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/undo/UndoManager.java"
click node_selection "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/SelectionManager.java"
click node_scripts "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/plugin/ScriptManager.java"
click node_restrictions "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/restrictions/RestrictionsController.java"
click node_notation "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/util/EngineeringNotationString.java"
click node_stringutil "https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/util/StringUtil.java"

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_web,node_desktop,node_controller,node_view,node_toolset,node_user toneBlue
class node_kernel,node_construction,node_objects,node_equation,node_expression,node_algorithms,node_geometry3d toneAmber
class node_appcore,node_spreadsheet,node_spreadsheetcore,node_gui toneMint
class node_materials,node_materialdata,node_exam,node_undo,node_selection,node_scripts,node_restrictions,node_notation,node_stringutil toneRose
```

## Components

### Interaction and views

- [Web app](https://github.com/geogebra/geogebra/blob/main/source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java): `source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java`
- [Desktop app](https://github.com/geogebra/geogebra/blob/main/source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java): `source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java`
- [2D interaction](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianController.java): `source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianController.java`
- [Euclidian view](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianView.java): `source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianView.java`
- [Math tools](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianConstants.java): `source/shared/common/src/main/java/org/geogebra/common/euclidian/EuclidianConstants.java`

### Mathematics engine

- [Math kernel](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java`
- [Construction model](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/Construction.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/Construction.java`
- [Math objects](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/geos/GeoElement.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/geos/GeoElement.java`
- [Equation expressions](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/Equation.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/Equation.java`
- [Expression trees](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/ExpressionNode.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/arithmetic/ExpressionNode.java`
- [Construction algorithms](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/kernel/algos/AlgoElement.java): `source/shared/common/src/main/java/org/geogebra/common/kernel/algos/AlgoElement.java`
- [3D geometry](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/geogebra3D/kernel3D/algos/Manager3D.java): `source/shared/common/src/main/java/org/geogebra/common/geogebra3D/kernel3D/algos/Manager3D.java`

### App capabilities

- [App core](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/App.java): `source/shared/common/src/main/java/org/geogebra/common/main/App.java`
- [Spreadsheet editing](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/spreadsheet/kernel/KernelCellDragPasteHandler.java): `source/shared/common/src/main/java/org/geogebra/common/spreadsheet/kernel/KernelCellDragPasteHandler.java`
- [Cell drag paste](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/spreadsheet/core/CellDragPasteHandler.java): `source/shared/common/src/main/java/org/geogebra/common/spreadsheet/core/CellDragPasteHandler.java`
- [Shared app UI](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/gui/GuiManager.java): `source/shared/common/src/main/java/org/geogebra/common/gui/GuiManager.java`

### Services and state

- [Material service](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/MowService.java): `source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/MowService.java`
- [Material data](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/Material.java): `source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/Material.java`
- [Exam storage](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/exam/TempStorage.java): `source/shared/common/src/main/java/org/geogebra/common/main/exam/TempStorage.java`
- [Undo history](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/undo/UndoManager.java): `source/shared/common/src/main/java/org/geogebra/common/main/undo/UndoManager.java`
- [Selection state](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/main/SelectionManager.java): `source/shared/common/src/main/java/org/geogebra/common/main/SelectionManager.java`
- [Scripting](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/plugin/ScriptManager.java): `source/shared/common/src/main/java/org/geogebra/common/plugin/ScriptManager.java`
- [App restrictions](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/restrictions/RestrictionsController.java): `source/shared/common/src/main/java/org/geogebra/common/restrictions/RestrictionsController.java`
- [Engineering notation](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/util/EngineeringNotationString.java): `source/shared/common/src/main/java/org/geogebra/common/util/EngineeringNotationString.java`
- [String utilities](https://github.com/geogebra/geogebra/blob/main/source/shared/common/src/main/java/org/geogebra/common/util/StringUtil.java): `source/shared/common/src/main/java/org/geogebra/common/util/StringUtil.java`

### Other components

- **App user**

## Connections

- App user → Web app: uses
- App user → Desktop app: uses
- Web app → App core: hosts (evidence: `source/web/web/src/main/java/org/geogebra/web/full/gui/GuiManagerW.java`)
- Desktop app → App core: hosts (evidence: `source/desktop/desktop/src/main/java/org/geogebra/desktop/gui/GuiManagerD.java`)
- 2D interaction → Euclidian view: interacts with
- Math tools → 2D interaction: selects modes
- Math kernel → Construction model: manages
- Construction model → Math objects: tracks (evidence: `source/shared/common/src/main/java/org/geogebra/common/kernel/Construction.java`)
- Math objects → Construction algorithms: updates (evidence: `source/shared/common/src/main/java/org/geogebra/common/kernel/geos/GeoElement.java`)
- Math kernel → Expression trees: evaluates (evidence: `source/shared/common/src/main/java/org/geogebra/common/kernel/Kernel.java`)
- Math kernel → Equation expressions: evaluates
- Math kernel → 3D geometry: supports
- Spreadsheet editing → Cell drag paste: uses (evidence: `source/shared/common/src/main/java/org/geogebra/common/spreadsheet/kernel/KernelCellDragPasteHandler.java`)
- App core → Undo history: tracks changes
- App core → Selection state: manages selection
- App core → Scripting: supports scripts
- App core → App restrictions: applies limits
- Material service → Material data: uses (evidence: `source/shared/common/src/main/java/org/geogebra/common/move/ggtapi/models/MowService.java`)
- Exam storage → Material data: uses (evidence: `source/shared/common/src/main/java/org/geogebra/common/main/exam/TempStorage.java`)
- Math kernel → Engineering notation: formats values (evidence: `source/shared/common/src/main/java/org/geogebra/common/util/EngineeringNotationString.java`)
- App core → String utilities: uses
