# manivaultstudio/core architecture

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

- Interactive diagram: https://gitdiagram.com/manivaultstudio/core
- Repository: https://github.com/manivaultstudio/core

## Overview

ManiVault Core is a modular visual-analytics framework: applications combine plugins for data loading, transformation, analysis and visualization, communicating through a shared core. The graph highlights that product workflow plus project/workspace persistence and the task/action infrastructure. Edges are limited to relationships explicit in the README or visible in indexed excerpts; where an important stage is documented but its implementation was not sampled, the connection is shown as unverified. Build and test infrastructure is excluded.

Main entry points: [`ManiVault/src/CoreInterface.h`](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/CoreInterface.h) (Core Interface), [`ManiVault/src/AbstractPluginManager.h`](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractPluginManager.h) (Plugin Manager), [`ManiVault/src/AbstractDataManager.h`](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractDataManager.h) (Data Manager), [`ManiVault/src/private/ProjectManager.cpp`](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/private/ProjectManager.cpp) (Project Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Core"]
  node_application["Application<br/>[Application.h]"]
  node_core["Core Interface<br/>[CoreInterface.h]"]
  node_managers["Core Managers<br/>[AbstractManager.h]"]
  node_actions["Action System"]
  node_task["Task Runtime<br/>[Task.h]"]
  node_taskui["Task UI"]
end

subgraph group_data["Data Workflow"]
  node_loader["Data Loading<br/>[LoaderPlugin.h]"]
  node_data_manager["Data Manager"]
  node_dataset["Datasets<br/>[Dataset.h]"]
  node_hierarchy["Data Hierarchy"]
end

subgraph group_plugins["Plugin Framework"]
  node_plugins["Plugin Manager"]
  node_analysis["Analysis And Transform<br/>[AnalysisPlugin.h]"]
  node_views["Visualization Views<br/>[ViewPlugin.h]"]
end

subgraph group_state["Projects And Workspaces"]
  node_project_manager["Project Manager<br/>[ProjectManager.cpp]"]
  node_project["Project State<br/>[Project.h]"]
  node_workspace_manager["Workspace Manager"]
  node_workspace["Workspace Layout<br/>[Workspace.h]"]
end

node_user(("Application User"))

node_user -.->|"uses"| node_application
node_application -.->|"initializes"| node_core
node_core -->|"exposes"| node_managers
node_core -->|"exposes"| node_plugins
node_core -->|"exposes"| node_data_manager
node_core -->|"exposes"| node_hierarchy
node_core -->|"exposes"| node_project_manager
node_core -->|"exposes"| node_workspace_manager
node_actions -->|"inherits"| node_managers
node_taskui -->|"gets tasks"| node_core
node_taskui -->|"presents"| node_task
node_data_manager -->|"manages"| node_dataset
node_loader -.->|"provides data"| node_data_manager
node_analysis -.->|"uses data"| node_data_manager
node_analysis -.->|"enables visualization"| node_views
node_plugins -.->|"loads plugins"| node_analysis
node_plugins -.->|"loads plugins"| node_loader
node_plugins -.->|"loads plugins"| node_views
node_project_manager -->|"manages"| node_project
node_project_manager -.->|"loads workspace"| node_workspace_manager
node_workspace_manager -->|"loads and saves"| node_workspace

click node_application "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Application.h"
click node_core "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/CoreInterface.h"
click node_managers "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractManager.h"
click node_actions "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractActionsManager.h"
click node_task "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Task.h"
click node_taskui "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/actions/TasksListAction.cpp"
click node_loader "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/LoaderPlugin.h"
click node_data_manager "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractDataManager.h"
click node_dataset "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Dataset.h"
click node_hierarchy "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractDataHierarchyManager.h"
click node_plugins "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractPluginManager.h"
click node_analysis "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AnalysisPlugin.h"
click node_views "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/ViewPlugin.h"
click node_project_manager "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/private/ProjectManager.cpp"
click node_project "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Project.h"
click node_workspace_manager "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/private/WorkspaceManager.cpp"
click node_workspace "https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Workspace.h"

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_application,node_core,node_managers,node_actions,node_task,node_taskui,node_user toneBlue
class node_loader,node_data_manager,node_dataset,node_hierarchy toneAmber
class node_plugins,node_analysis,node_views toneMint
class node_project_manager,node_project,node_workspace_manager,node_workspace toneRose
```

## Components

### Application Core

- [Application](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Application.h): `ManiVault/src/Application.h`
- [Core Interface](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/CoreInterface.h): `ManiVault/src/CoreInterface.h`
- [Core Managers](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractManager.h): `ManiVault/src/AbstractManager.h`
- [Action System](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractActionsManager.h): `ManiVault/src/AbstractActionsManager.h`
- [Task Runtime](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Task.h): `ManiVault/src/Task.h`
- [Task UI](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/actions/TasksListAction.cpp): `ManiVault/src/actions/TasksListAction.cpp`

### Data Workflow

- [Data Loading](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/LoaderPlugin.h): `ManiVault/src/LoaderPlugin.h`
- [Data Manager](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractDataManager.h): `ManiVault/src/AbstractDataManager.h`
- [Datasets](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Dataset.h): `ManiVault/src/Dataset.h`
- [Data Hierarchy](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractDataHierarchyManager.h): `ManiVault/src/AbstractDataHierarchyManager.h`

### Plugin Framework

- [Plugin Manager](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AbstractPluginManager.h): `ManiVault/src/AbstractPluginManager.h`
- [Analysis And Transform](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/AnalysisPlugin.h): `ManiVault/src/AnalysisPlugin.h`
- [Visualization Views](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/ViewPlugin.h): `ManiVault/src/ViewPlugin.h`

### Projects And Workspaces

- [Project Manager](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/private/ProjectManager.cpp): `ManiVault/src/private/ProjectManager.cpp`
- [Project State](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Project.h): `ManiVault/src/Project.h`
- [Workspace Manager](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/private/WorkspaceManager.cpp): `ManiVault/src/private/WorkspaceManager.cpp`
- [Workspace Layout](https://github.com/manivaultstudio/core/blob/master/ManiVault/src/Workspace.h): `ManiVault/src/Workspace.h`

### Other components

- **Application User**

## Connections

- Application User → Application: uses
- Application → Core Interface: initializes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Core Managers: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Plugin Manager: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Data Manager: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Data Hierarchy: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Project Manager: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Core Interface → Workspace Manager: exposes (evidence: `ManiVault/src/CoreInterface.h`)
- Action System → Core Managers: inherits (evidence: `ManiVault/src/AbstractActionsManager.h`)
- Task UI → Core Interface: gets tasks (evidence: `ManiVault/src/actions/TasksListAction.cpp`)
- Task UI → Task Runtime: presents (evidence: `ManiVault/src/actions/TasksListAction.cpp`)
- Data Manager → Datasets: manages (evidence: `ManiVault/src/AbstractDataManager.h`)
- Data Loading → Data Manager: provides data
- Analysis And Transform → Data Manager: uses data
- Analysis And Transform → Visualization Views: enables visualization (evidence: `README.md`)
- Plugin Manager → Analysis And Transform: loads plugins (evidence: `README.md`)
- Plugin Manager → Data Loading: loads plugins (evidence: `README.md`)
- Plugin Manager → Visualization Views: loads plugins (evidence: `README.md`)
- Project Manager → Project State: manages
- Project Manager → Workspace Manager: loads workspace
- Workspace Manager → Workspace Layout: loads and saves (evidence: `ManiVault/src/private/WorkspaceManager.cpp`)
