# mitre-attack/attack-navigator architecture

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

- Interactive diagram: https://gitdiagram.com/mitre-attack/attack-navigator
- Repository: https://github.com/mitre-attack/attack-navigator

## Overview

ATT&CK Navigator is a client-side Angular application for exploring ATT&CK matrices and creating annotated layers. Users load domain/version data, open or build layers, inspect and edit technique cells, then export or compare their work. The graph separates domain data, layer state, matrix interaction, and application workflows. Several connections are supported by the excerpts or SOURCE INDEX; broader product capabilities such as export and version upgrades are documented or named there, but their internal wiring is not fully shown.

Main entry points: [`nav-app/src/app/services/data.service.ts`](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/data.service.ts) (Domain data service), [`nav-app/src/app/tabs/tabs.component.ts`](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/tabs/tabs.component.ts) (Tabs and layer workflow), [`nav-app/src/app/services/viewmodels.service.ts`](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/viewmodels.service.ts) (View model service), [`nav-app/src/app/matrix/technique-cell/technique-cell.component.ts`](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/technique-cell/technique-cell.component.ts) (Technique cell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_domain["ATT&amp;CK Domain Data"]
  node_data["Domain data service<br/>[data.service.ts]"]
  node_stix["ATT&amp;CK STIX model<br/>[technique.ts]"]
  node_taxii["TAXII client<br/>[taxii2lib.ts]"]
end

subgraph group_layers["Layers and View State"]
  node_viewmodels["View model service"]
  node_viewmodel["Layer view model<br/>[view-model.ts]"]
  node_techvm["Technique annotations<br/>[technique-vm.ts]"]
end

subgraph group_matrix["Matrix Exploration"]
  node_matrix["Matrix layouts<br/>[matrix-common.ts]"]
  node_cell["Matrix cell behavior<br/>[cell.ts]"]
  node_techcell["Technique cell"]
  node_context["Cell context menu"]
  node_search["Search and multiselect"]
end

subgraph group_workflow["Application Workflows"]
  node_app["Application shell<br/>[app.component.ts]"]
  node_tabs["Tabs and layer workflow<br/>[tabs.component.ts]"]
  node_config["Configuration<br/>[config.service.ts]"]
  node_sidebar["Layer controls"]
  node_datatable["Data table"]
  node_upgrade["Layer version upgrade"]
  node_svg["SVG export"]
end

node_user(("Navigator user"))
node_attck[("ATT&amp;CK data source")]
node_browser[("Browser file storage")]

node_user -->|"opens"| node_app
node_app -->|"hosts"| node_tabs
node_app -->|"uses"| node_config
node_tabs -->|"loads data"| node_data
node_tabs -->|"creates layers"| node_viewmodels
node_data -->|"reads settings"| node_config
node_data -->|"builds objects"| node_stix
node_data -->|"uses client"| node_taxii
node_attck -.->|"provides domain data"| node_data
node_viewmodels -->|"reads domain"| node_data
node_viewmodels -->|"creates"| node_viewmodel
node_viewmodel -.->|"stores annotations"| node_techvm
node_matrix -->|"renders cells"| node_techcell
node_techcell -->|"extends"| node_cell
node_techcell -->|"shows menu"| node_context
node_context -->|"changes selection"| node_viewmodel
node_sidebar -->|"hosts search"| node_search
node_search -->|"queries domain"| node_data
node_search -->|"uses view models"| node_viewmodels
node_tabs -->|"opens table"| node_datatable
node_tabs -->|"upgrades layers"| node_upgrade
node_tabs -->|"exports matrix"| node_svg
node_user -.->|"keeps layer files"| node_browser

click node_app "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/app.component.ts"
click node_tabs "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/tabs/tabs.component.ts"
click node_config "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/config.service.ts"
click node_data "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/data.service.ts"
click node_stix "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/stix/technique.ts"
click node_taxii "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/utils/taxii2lib.ts"
click node_viewmodels "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/viewmodels.service.ts"
click node_viewmodel "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/view-model.ts"
click node_techvm "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/technique-vm.ts"
click node_matrix "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/matrix-common.ts"
click node_cell "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/cell.ts"
click node_techcell "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/technique-cell/technique-cell.component.ts"
click node_context "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/technique-cell/contextmenu/contextmenu.component.ts"
click node_search "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/search-and-multiselect/search-and-multiselect.component.ts"
click node_sidebar "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/sidebar/sidebar.component.ts"
click node_datatable "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/datatable/data-table.component.ts"
click node_upgrade "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/layer-upgrade/layer-upgrade.component.ts"
click node_svg "https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/svg-export/svg-export.component.ts"

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_data,node_stix,node_taxii,node_user toneBlue
class node_viewmodels,node_viewmodel,node_techvm,node_attck,node_browser toneAmber
class node_matrix,node_cell,node_techcell,node_context,node_search toneMint
class node_app,node_tabs,node_config,node_sidebar,node_datatable,node_upgrade,node_svg toneRose
```

## Components

### ATT&CK Domain Data

- [Domain data service](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/data.service.ts): `nav-app/src/app/services/data.service.ts`
- [ATT&CK STIX model](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/stix/technique.ts): `nav-app/src/app/classes/stix/technique.ts`
- [TAXII client](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/utils/taxii2lib.ts): `nav-app/src/app/utils/taxii2lib.ts`

### Layers and View State

- [View model service](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/viewmodels.service.ts): `nav-app/src/app/services/viewmodels.service.ts`
- [Layer view model](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/view-model.ts): `nav-app/src/app/classes/view-model.ts`
- [Technique annotations](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/classes/technique-vm.ts): `nav-app/src/app/classes/technique-vm.ts`

### Matrix Exploration

- [Matrix layouts](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/matrix-common.ts): `nav-app/src/app/matrix/matrix-common.ts`
- [Matrix cell behavior](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/cell.ts): `nav-app/src/app/matrix/cell.ts`
- [Technique cell](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/technique-cell/technique-cell.component.ts): `nav-app/src/app/matrix/technique-cell/technique-cell.component.ts`
- [Cell context menu](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/matrix/technique-cell/contextmenu/contextmenu.component.ts): `nav-app/src/app/matrix/technique-cell/contextmenu/contextmenu.component.ts`
- [Search and multiselect](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/search-and-multiselect/search-and-multiselect.component.ts): `nav-app/src/app/search-and-multiselect/search-and-multiselect.component.ts`

### Application Workflows

- [Application shell](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/app.component.ts): `nav-app/src/app/app.component.ts`
- [Tabs and layer workflow](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/tabs/tabs.component.ts): `nav-app/src/app/tabs/tabs.component.ts`
- [Configuration](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/services/config.service.ts): `nav-app/src/app/services/config.service.ts`
- [Layer controls](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/sidebar/sidebar.component.ts): `nav-app/src/app/sidebar/sidebar.component.ts`
- [Data table](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/datatable/data-table.component.ts): `nav-app/src/app/datatable/data-table.component.ts`
- [Layer version upgrade](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/layer-upgrade/layer-upgrade.component.ts): `nav-app/src/app/layer-upgrade/layer-upgrade.component.ts`
- [SVG export](https://github.com/mitre-attack/attack-navigator/blob/main/nav-app/src/app/svg-export/svg-export.component.ts): `nav-app/src/app/svg-export/svg-export.component.ts`

### Other components

- **Navigator user**
- **ATT&CK data source**
- **Browser file storage**

## Connections

- Navigator user → Application shell: opens
- Application shell → Tabs and layer workflow: hosts (evidence: `nav-app/src/app/app.component.ts`)
- Application shell → Configuration: uses (evidence: `nav-app/src/app/app.component.ts`)
- Tabs and layer workflow → Domain data service: loads data (evidence: `nav-app/src/app/tabs/tabs.component.ts`)
- Tabs and layer workflow → View model service: creates layers (evidence: `nav-app/src/app/tabs/tabs.component.ts`)
- Domain data service → Configuration: reads settings (evidence: `nav-app/src/app/services/data.service.ts`)
- Domain data service → ATT&CK STIX model: builds objects (evidence: `nav-app/src/app/services/data.service.ts`)
- Domain data service → TAXII client: uses client (evidence: `nav-app/src/app/services/data.service.ts`)
- ATT&CK data source → Domain data service: provides domain data
- View model service → Domain data service: reads domain (evidence: `nav-app/src/app/services/viewmodels.service.ts`)
- View model service → Layer view model: creates (evidence: `nav-app/src/app/services/viewmodels.service.ts`)
- Layer view model → Technique annotations: stores annotations
- Matrix layouts → Technique cell: renders cells (evidence: `nav-app/src/app/matrix/matrix-flat/matrix-flat.component.ts`)
- Technique cell → Matrix cell behavior: extends (evidence: `nav-app/src/app/matrix/technique-cell/technique-cell.component.ts`)
- Technique cell → Cell context menu: shows menu (evidence: `nav-app/src/app/matrix/technique-cell/technique-cell.component.ts`)
- Cell context menu → Layer view model: changes selection (evidence: `nav-app/src/app/matrix/technique-cell/contextmenu/contextmenu.component.ts`)
- Layer controls → Search and multiselect: hosts search (evidence: `nav-app/src/app/sidebar/sidebar.component.ts`)
- Search and multiselect → Domain data service: queries domain (evidence: `nav-app/src/app/search-and-multiselect/search-and-multiselect.component.ts`)
- Search and multiselect → View model service: uses view models (evidence: `nav-app/src/app/search-and-multiselect/search-and-multiselect.component.ts`)
- Tabs and layer workflow → Data table: opens table (evidence: `nav-app/src/app/tabs/tabs.component.ts`)
- Tabs and layer workflow → Layer version upgrade: upgrades layers (evidence: `nav-app/src/app/tabs/tabs.component.ts`)
- Tabs and layer workflow → SVG export: exports matrix (evidence: `nav-app/src/app/tabs/tabs.component.ts`)
- Navigator user → Browser file storage: keeps layer files
