How anonymousraid/osint-mapping-tool works
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: ProjectContext.jsx Project state · MapTab.jsx Google map · App.jsx App routing · MapTabOSM.jsx OpenStreetMap
Components 27
Workspace flow
- App routing
src/App.jsx - Project landing
src/components/Landing.jsx - Project workspace
src/components/ProjectView.jsx
Research graph
- Identifier graph
src/components/InfoTab.jsx - Identifier records
src/components/IdentifierModal.jsx - Identifier types
src/identifierTypes.js - Icon selection
src/components/IconPicker.jsx
Map research
- Google map
src/components/MapTab.jsx - OpenStreetMap
src/components/MapTabOSM.jsx - Place search
src/components/MapSearchBox.jsx - Pin editing
src/components/PinModal.jsx - Pin details
src/components/PinInfoCard.jsx
State and persistence
- Project state
src/context/ProjectContext.jsx - Project files
src/utils/projectIO.js - Recent projects
src/utils/recentProjects.js - Custom icon state
src/context/CustomIconsContext.jsx - Graph undo history
src/context/NodeHistoryContext.jsx - Cross-tab navigation
src/context/NavigationContext.jsx - Map configuration
src/context/AppConfigContext.jsx - Configuration loading
src/utils/appConfig.js - Theme state
src/context/ThemeContext.jsx
Other components
- Analyst
- Google Maps services
- Nominatim service
- OpenStreetMap tiles
- Browser local storage
- OSINT JSON file
Connections 42
- Analyst → App routing: opens
README.md - App routing → Project landing: shows
src/App.jsx - App routing → Project workspace: shows
src/App.jsx - App routing → Project state: reads state
src/App.jsx - App routing → Map configuration: checks setup
src/App.jsx - Project landing → Project state: manages projects
src/components/Landing.jsx - Project landing → Recent projects: lists recents
src/components/Landing.jsx - Project workspace → Identifier graph: shows tab
src/components/ProjectView.jsx - Project workspace → Google map: shows tab
src/components/ProjectView.jsx - Project workspace → Project state: reads project
src/components/ProjectView.jsx - Project state → Project files: loads and saves
src/context/ProjectContext.jsx - Project state → Recent projects: snapshots project
src/context/ProjectContext.jsx - Project state → OSINT JSON file: imports or downloads
README.md - Project state → Browser local storage: autosaves snapshots
README.md - Identifier graph → Identifier records: edits nodes
src/components/InfoTab.jsx - Identifier graph → Graph undo history: records actions
src/context/NodeHistoryContext.jsx - Identifier records → Identifier types: uses definitions
src/components/IdentifierModal.jsx - Identifier records → Icon selection: selects icon
src/components/IdentifierModal.jsx - Icon selection → Custom icon state: reads icons
src/components/IconPicker.jsx - Custom icon state → Browser local storage: persists icons
README.md - Identifier graph → Cross-tab navigation: requests focus
src/components/InfoTab.jsx - Google map → Map configuration: selects provider
src/components/MapTab.jsx - Google map → OpenStreetMap: renders OSM mode
src/components/MapTab.jsx - Google map → Project state: adds pins
src/components/MapTab.jsx - Google map → Place search: provides search
src/components/MapTab.jsx - Google map → Pin editing: edits pins
src/components/MapTab.jsx - Google map → Google Maps services: uses map services
README.md - Place search → Google Maps services: searches places
README.md - OpenStreetMap → Project state: manages pins
src/components/MapTabOSM.jsx - OpenStreetMap → Pin editing: edits pins
src/components/MapTabOSM.jsx - OpenStreetMap → Nominatim service: searches and geocodes
README.md - OpenStreetMap → OpenStreetMap tiles: loads map tiles
README.md - Pin editing → Project state: updates pin links
src/components/PinModal.jsx - Pin editing → Identifier types: uses identifier definitions
src/components/PinModal.jsx - Pin details → Project state: reads linked data
src/components/PinInfoCard.jsx - Pin details → Cross-tab navigation: navigates to identifier
src/components/PinInfoCard.jsx - Cross-tab navigation → Identifier graph: targets identifier
src/context/NavigationContext.jsx - Cross-tab navigation → Google map: targets pin
src/context/NavigationContext.jsx - Map configuration → Configuration loading: loads settings
src/context/AppConfigContext.jsx - Configuration loading → Browser local storage: reads and writes settings
src/utils/appConfig.js - Map configuration → Google Maps services: supplies API key
README.md - Theme state → Browser local storage: persists preference
src/context/ThemeContext.jsx