# anonymousraid/osint-mapping-tool architecture

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

- Interactive diagram: https://gitdiagram.com/anonymousraid/osint-mapping-tool
- Repository: https://github.com/anonymousraid/osint-mapping-tool

## Overview

OSINT Mapping Tool is a local-first research workspace: users create a project, record and connect typed identifiers, pin and annotate places, link pins to identifiers, then save or reopen the JSON project. The UI separates the information graph from Google Maps and OpenStreetMap views; contexts coordinate project state, navigation, history, settings and themes. README-documented search, geocoding, custom icons, recent-project recovery and map-provider options are represented. Some feature paths are documented but their implementation was not sampled, so those links are marked unverified.

Main entry points: [`src/context/ProjectContext.jsx`](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/ProjectContext.jsx) (Project state), [`src/components/MapTab.jsx`](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTab.jsx) (Google map), [`src/App.jsx`](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/App.jsx) (App routing), [`src/components/MapTabOSM.jsx`](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTabOSM.jsx) (OpenStreetMap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace flow"]
  node_app["App routing<br/>[App.jsx]"]
  node_landing["Project landing<br/>[Landing.jsx]"]
  node_projectview["Project workspace<br/>[ProjectView.jsx]"]
end

subgraph group_research["Research graph"]
  node_infotab["Identifier graph<br/>[InfoTab.jsx]"]
  node_identifier["Identifier records"]
  node_types["Identifier types<br/>[identifierTypes.js]"]
  node_icons["Icon selection<br/>[IconPicker.jsx]"]
end

subgraph group_mapping["Map research"]
  node_map["Google map<br/>[MapTab.jsx]"]
  node_osm["OpenStreetMap<br/>[MapTabOSM.jsx]"]
  node_mapsearch["Place search<br/>[MapSearchBox.jsx]"]
  node_pin["Pin editing<br/>[PinModal.jsx]"]
  node_pininfo["Pin details<br/>[PinInfoCard.jsx]"]
end

subgraph group_state["State and persistence"]
  node_projectctx["Project state<br/>[ProjectContext.jsx]"]
  node_projectio["Project files<br/>[projectIO.js]"]
  node_recents[("Recent projects<br/>[recentProjects.js]")]
  node_customicons["Custom icon state"]
  node_history["Graph undo history"]
  node_navigation["Cross-tab navigation"]
  node_config["Map configuration"]
  node_configutil["Configuration loading<br/>[appConfig.js]"]
  node_theme["Theme state<br/>[ThemeContext.jsx]"]
end

node_analyst(("Analyst"))
node_google["Google Maps services"]
node_nominatim["Nominatim service"]
node_osmtiles["OpenStreetMap tiles"]
node_browserstore[("Browser local storage")]
node_jsonfile["OSINT JSON file"]

node_analyst -->|"opens"| node_app
node_app -->|"shows"| node_landing
node_app -->|"shows"| node_projectview
node_app -->|"reads state"| node_projectctx
node_app -->|"checks setup"| node_config
node_landing -->|"manages projects"| node_projectctx
node_landing -->|"lists recents"| node_recents
node_projectview -->|"shows tab"| node_infotab
node_projectview -->|"shows tab"| node_map
node_projectview -->|"reads project"| node_projectctx
node_projectctx -->|"loads and saves"| node_projectio
node_projectctx -->|"snapshots project"| node_recents
node_projectctx -.->|"imports or downloads"| node_jsonfile
node_projectctx -.->|"autosaves snapshots"| node_browserstore
node_infotab -->|"edits nodes"| node_identifier
node_infotab -.->|"records actions"| node_history
node_identifier -->|"uses definitions"| node_types
node_identifier -->|"selects icon"| node_icons
node_icons -->|"reads icons"| node_customicons
node_customicons -.->|"persists icons"| node_browserstore
node_infotab -.->|"requests focus"| node_navigation
node_map -->|"selects provider"| node_config
node_map -->|"renders OSM mode"| node_osm
node_map -->|"adds pins"| node_projectctx
node_map -->|"provides search"| node_mapsearch
node_map -->|"edits pins"| node_pin
node_map -.->|"uses map services"| node_google
node_mapsearch -.->|"searches places"| node_google
node_osm -->|"manages pins"| node_projectctx
node_osm -.->|"edits pins"| node_pin
node_osm -.->|"searches and geocodes"| node_nominatim
node_osm -.->|"loads map tiles"| node_osmtiles
node_pin -->|"updates pin links"| node_projectctx
node_pin -->|"uses identifier definitions"| node_types
node_pininfo -->|"reads linked data"| node_projectctx
node_pininfo -->|"navigates to identifier"| node_navigation
node_navigation -.->|"targets identifier"| node_infotab
node_navigation -.->|"targets pin"| node_map
node_config -->|"loads settings"| node_configutil
node_configutil -.->|"reads and writes settings"| node_browserstore
node_config -.->|"supplies API key"| node_google
node_theme -.->|"persists preference"| node_browserstore

click node_app "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/App.jsx"
click node_landing "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/Landing.jsx"
click node_projectview "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/ProjectView.jsx"
click node_projectctx "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/ProjectContext.jsx"
click node_projectio "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/projectIO.js"
click node_recents "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/recentProjects.js"
click node_infotab "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/InfoTab.jsx"
click node_identifier "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/IdentifierModal.jsx"
click node_types "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/identifierTypes.js"
click node_icons "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/IconPicker.jsx"
click node_customicons "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/CustomIconsContext.jsx"
click node_history "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/NodeHistoryContext.jsx"
click node_map "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTab.jsx"
click node_osm "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTabOSM.jsx"
click node_mapsearch "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapSearchBox.jsx"
click node_pin "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/PinModal.jsx"
click node_pininfo "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/PinInfoCard.jsx"
click node_navigation "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/NavigationContext.jsx"
click node_config "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/AppConfigContext.jsx"
click node_configutil "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/appConfig.js"
click node_theme "https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/ThemeContext.jsx"

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_landing,node_projectview toneBlue
class node_infotab,node_identifier,node_types,node_icons,node_browserstore toneAmber
class node_map,node_osm,node_mapsearch,node_pin,node_pininfo toneMint
class node_projectctx,node_projectio,node_recents,node_customicons,node_history,node_navigation,node_config,node_configutil,node_theme toneRose
class node_analyst,node_google,node_nominatim,node_osmtiles,node_jsonfile toneIndigo
```

## Components

### Workspace flow

- [App routing](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/App.jsx): `src/App.jsx`
- [Project landing](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/Landing.jsx): `src/components/Landing.jsx`
- [Project workspace](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/ProjectView.jsx): `src/components/ProjectView.jsx`

### Research graph

- [Identifier graph](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/InfoTab.jsx): `src/components/InfoTab.jsx`
- [Identifier records](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/IdentifierModal.jsx): `src/components/IdentifierModal.jsx`
- [Identifier types](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/identifierTypes.js): `src/identifierTypes.js`
- [Icon selection](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/IconPicker.jsx): `src/components/IconPicker.jsx`

### Map research

- [Google map](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTab.jsx): `src/components/MapTab.jsx`
- [OpenStreetMap](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapTabOSM.jsx): `src/components/MapTabOSM.jsx`
- [Place search](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/MapSearchBox.jsx): `src/components/MapSearchBox.jsx`
- [Pin editing](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/PinModal.jsx): `src/components/PinModal.jsx`
- [Pin details](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/components/PinInfoCard.jsx): `src/components/PinInfoCard.jsx`

### State and persistence

- [Project state](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/ProjectContext.jsx): `src/context/ProjectContext.jsx`
- [Project files](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/projectIO.js): `src/utils/projectIO.js`
- [Recent projects](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/recentProjects.js): `src/utils/recentProjects.js`
- [Custom icon state](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/CustomIconsContext.jsx): `src/context/CustomIconsContext.jsx`
- [Graph undo history](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/NodeHistoryContext.jsx): `src/context/NodeHistoryContext.jsx`
- [Cross-tab navigation](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/NavigationContext.jsx): `src/context/NavigationContext.jsx`
- [Map configuration](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/AppConfigContext.jsx): `src/context/AppConfigContext.jsx`
- [Configuration loading](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/utils/appConfig.js): `src/utils/appConfig.js`
- [Theme state](https://github.com/anonymousraid/osint-mapping-tool/blob/main/src/context/ThemeContext.jsx): `src/context/ThemeContext.jsx`

### Other components

- **Analyst**
- **Google Maps services**
- **Nominatim service**
- **OpenStreetMap tiles**
- **Browser local storage**
- **OSINT JSON file**

## Connections

- Analyst → App routing: opens (evidence: `README.md`)
- App routing → Project landing: shows (evidence: `src/App.jsx`)
- App routing → Project workspace: shows (evidence: `src/App.jsx`)
- App routing → Project state: reads state (evidence: `src/App.jsx`)
- App routing → Map configuration: checks setup (evidence: `src/App.jsx`)
- Project landing → Project state: manages projects (evidence: `src/components/Landing.jsx`)
- Project landing → Recent projects: lists recents (evidence: `src/components/Landing.jsx`)
- Project workspace → Identifier graph: shows tab (evidence: `src/components/ProjectView.jsx`)
- Project workspace → Google map: shows tab (evidence: `src/components/ProjectView.jsx`)
- Project workspace → Project state: reads project (evidence: `src/components/ProjectView.jsx`)
- Project state → Project files: loads and saves (evidence: `src/context/ProjectContext.jsx`)
- Project state → Recent projects: snapshots project (evidence: `src/context/ProjectContext.jsx`)
- Project state → OSINT JSON file: imports or downloads (evidence: `README.md`)
- Project state → Browser local storage: autosaves snapshots (evidence: `README.md`)
- Identifier graph → Identifier records: edits nodes (evidence: `src/components/InfoTab.jsx`)
- Identifier graph → Graph undo history: records actions (evidence: `src/context/NodeHistoryContext.jsx`)
- Identifier records → Identifier types: uses definitions (evidence: `src/components/IdentifierModal.jsx`)
- Identifier records → Icon selection: selects icon (evidence: `src/components/IdentifierModal.jsx`)
- Icon selection → Custom icon state: reads icons (evidence: `src/components/IconPicker.jsx`)
- Custom icon state → Browser local storage: persists icons (evidence: `README.md`)
- Identifier graph → Cross-tab navigation: requests focus (evidence: `src/components/InfoTab.jsx`)
- Google map → Map configuration: selects provider (evidence: `src/components/MapTab.jsx`)
- Google map → OpenStreetMap: renders OSM mode (evidence: `src/components/MapTab.jsx`)
- Google map → Project state: adds pins (evidence: `src/components/MapTab.jsx`)
- Google map → Place search: provides search (evidence: `src/components/MapTab.jsx`)
- Google map → Pin editing: edits pins (evidence: `src/components/MapTab.jsx`)
- Google map → Google Maps services: uses map services (evidence: `README.md`)
- Place search → Google Maps services: searches places (evidence: `README.md`)
- OpenStreetMap → Project state: manages pins (evidence: `src/components/MapTabOSM.jsx`)
- OpenStreetMap → Pin editing: edits pins (evidence: `src/components/MapTabOSM.jsx`)
- OpenStreetMap → Nominatim service: searches and geocodes (evidence: `README.md`)
- OpenStreetMap → OpenStreetMap tiles: loads map tiles (evidence: `README.md`)
- Pin editing → Project state: updates pin links (evidence: `src/components/PinModal.jsx`)
- Pin editing → Identifier types: uses identifier definitions (evidence: `src/components/PinModal.jsx`)
- Pin details → Project state: reads linked data (evidence: `src/components/PinInfoCard.jsx`)
- Pin details → Cross-tab navigation: navigates to identifier (evidence: `src/components/PinInfoCard.jsx`)
- Cross-tab navigation → Identifier graph: targets identifier (evidence: `src/context/NavigationContext.jsx`)
- Cross-tab navigation → Google map: targets pin (evidence: `src/context/NavigationContext.jsx`)
- Map configuration → Configuration loading: loads settings (evidence: `src/context/AppConfigContext.jsx`)
- Configuration loading → Browser local storage: reads and writes settings (evidence: `src/utils/appConfig.js`)
- Map configuration → Google Maps services: supplies API key (evidence: `README.md`)
- Theme state → Browser local storage: persists preference (evidence: `src/context/ThemeContext.jsx`)
