# azurejoga/osint-explorer architecture

> Architecture diagram of the GitHub repository azurejoga/osint-explorer, 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/azurejoga/osint-explorer
- Repository: https://github.com/azurejoga/osint-explorer

## Overview

OSINT Brasil is a cross-platform explorer for a multilingual catalog of OSINT tools. Users enter the tools view, browse categories or search and filter the catalog, then inspect tools in one of five views and optionally save favorites. The app loads bundled catalog data, optionally merges tools parsed from awesome-osint, and caches results locally. Supporting branches include category and translation metadata, SEO, and adding tools. README and sampled source establish the main flow; unsampled platform-shell wiring is shown only as documented.

Main entry points: [`src/App.jsx`](https://github.com/azurejoga/osint-explorer/blob/master/src/App.jsx) (App shell), [`src/context/AppContext.jsx`](https://github.com/azurejoga/osint-explorer/blob/master/src/context/AppContext.jsx) (App state), [`src/components/ToolCard.jsx`](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolCard.jsx) (Grid cards), [`src/hooks/useToolsLoader.js`](https://github.com/azurejoga/osint-explorer/blob/master/src/hooks/useToolsLoader.js) (Tool loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog data"]
  node_loader["Tool loader<br/>[useToolsLoader.js]"]
  node_parser["Markdown parser<br/>[parseMd.js]"]
  node_bundled["Bundled catalog"]
  node_categories["Category metadata<br/>[categories.js]"]
  node_translations["Translations<br/>[i18n.js]"]
end

subgraph group_state["Application state"]
  node_statecore["App state<br/>[AppContext.jsx]"]
  node_localcache[("Browser cache")]
end

subgraph group_experience["Explorer interface"]
  node_app["App shell<br/>[App.jsx]"]
  node_header["Navigation controls<br/>[Header.jsx]"]
  node_sidebar["Category sidebar<br/>[Sidebar.jsx]"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_toolcard["Grid cards<br/>[ToolCard.jsx]"]
  node_toolrow["List items<br/>[ToolListItem.jsx]"]
  node_table["Table view<br/>[ToolTable.jsx]"]
  node_tree["Tree view<br/>[ToolTree.jsx]"]
  node_compact["Compact view<br/>[ToolCompact.jsx]"]
  node_addtool["Add tool dialog<br/>[AddToolModal.jsx]"]
  node_favorite["Favorite control<br/>[FavoriteButton.jsx]"]
  node_status["Status badge<br/>[StatusBadge.jsx]"]
end

subgraph group_delivery["Platform and metadata"]
  node_seo["SEO metadata<br/>[useSEO.js]"]
  node_favicon["Favicon lookup<br/>[favicon.js]"]
  node_electron["Electron host<br/>[main.js]"]
  node_android["Android host<br/>[MainActivity.java]"]
end

node_visitor(("Investigator"))
node_awesome["awesome-osint README"]
node_google(("Google favicon service"))

node_visitor -->|"uses"| node_app
node_app -->|"provides state"| node_statecore
node_app -->|"renders"| node_header
node_app -->|"renders"| node_sidebar
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_toolcard
node_app -->|"renders"| node_toolrow
node_app -->|"renders"| node_table
node_app -->|"renders"| node_tree
node_app -->|"renders"| node_compact
node_app -->|"updates metadata"| node_seo
node_statecore -->|"loads tools"| node_loader
node_statecore -->|"localizes state"| node_translations
node_loader -->|"fetches catalog"| node_bundled
node_loader -->|"fetches and merges"| node_awesome
node_loader -->|"parses Markdown"| node_parser
node_loader -->|"reads and writes"| node_localcache
node_statecore -->|"persists preferences"| node_localcache
node_sidebar -->|"sets filters"| node_statecore
node_sidebar -->|"uses categories"| node_categories
node_header -->|"controls settings"| node_statecore
node_addtool -->|"updates catalog"| node_statecore
node_toolcard -->|"renders status"| node_status
node_toolcard -->|"renders control"| node_favorite
node_table -->|"renders status"| node_status
node_table -->|"renders control"| node_favorite
node_tree -->|"renders status"| node_status
node_tree -->|"renders control"| node_favorite
node_toolcard -->|"uses categories"| node_categories
node_toolcard -->|"localizes text"| node_translations
node_toolcard -->|"gets icon URL"| node_favicon
node_favicon -->|"requests favicon"| node_google
node_table -->|"gets icon URL"| node_favicon
node_electron -.->|"hosts app"| node_app
node_android -.->|"hosts app"| node_app

click node_app "https://github.com/azurejoga/osint-explorer/blob/master/src/App.jsx"
click node_statecore "https://github.com/azurejoga/osint-explorer/blob/master/src/context/AppContext.jsx"
click node_loader "https://github.com/azurejoga/osint-explorer/blob/master/src/hooks/useToolsLoader.js"
click node_parser "https://github.com/azurejoga/osint-explorer/blob/master/src/utils/parseMd.js"
click node_categories "https://github.com/azurejoga/osint-explorer/blob/master/src/data/categories.js"
click node_translations "https://github.com/azurejoga/osint-explorer/blob/master/src/data/i18n.js"
click node_header "https://github.com/azurejoga/osint-explorer/blob/master/src/components/Header.jsx"
click node_sidebar "https://github.com/azurejoga/osint-explorer/blob/master/src/components/Sidebar.jsx"
click node_landing "https://github.com/azurejoga/osint-explorer/blob/master/src/components/LandingPage.jsx"
click node_toolcard "https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolCard.jsx"
click node_toolrow "https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolListItem.jsx"
click node_table "https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolTable.jsx"
click node_tree "https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolTree.jsx"
click node_compact "https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolCompact.jsx"
click node_addtool "https://github.com/azurejoga/osint-explorer/blob/master/src/components/AddToolModal.jsx"
click node_favorite "https://github.com/azurejoga/osint-explorer/blob/master/src/components/FavoriteButton.jsx"
click node_status "https://github.com/azurejoga/osint-explorer/blob/master/src/components/StatusBadge.jsx"
click node_seo "https://github.com/azurejoga/osint-explorer/blob/master/src/hooks/useSEO.js"
click node_favicon "https://github.com/azurejoga/osint-explorer/blob/master/src/utils/favicon.js"
click node_electron "https://github.com/azurejoga/osint-explorer/blob/master/electron/main.js"
click node_android "https://github.com/azurejoga/osint-explorer/blob/master/android/app/src/main/java/com/osint/tools/MainActivity.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_loader,node_parser,node_bundled,node_categories,node_translations toneBlue
class node_statecore,node_localcache toneAmber
class node_app,node_header,node_sidebar,node_landing,node_toolcard,node_toolrow,node_table,node_tree,node_compact,node_addtool,node_favorite,node_status toneMint
class node_seo,node_favicon,node_electron,node_android toneRose
class node_visitor,node_awesome,node_google toneIndigo
```

## Components

### Catalog data

- [Tool loader](https://github.com/azurejoga/osint-explorer/blob/master/src/hooks/useToolsLoader.js): `src/hooks/useToolsLoader.js`
- [Markdown parser](https://github.com/azurejoga/osint-explorer/blob/master/src/utils/parseMd.js): `src/utils/parseMd.js`
- **Bundled catalog**
- [Category metadata](https://github.com/azurejoga/osint-explorer/blob/master/src/data/categories.js): `src/data/categories.js`
- [Translations](https://github.com/azurejoga/osint-explorer/blob/master/src/data/i18n.js): `src/data/i18n.js`

### Application state

- [App state](https://github.com/azurejoga/osint-explorer/blob/master/src/context/AppContext.jsx): `src/context/AppContext.jsx`
- **Browser cache**

### Explorer interface

- [App shell](https://github.com/azurejoga/osint-explorer/blob/master/src/App.jsx): `src/App.jsx`
- [Navigation controls](https://github.com/azurejoga/osint-explorer/blob/master/src/components/Header.jsx): `src/components/Header.jsx`
- [Category sidebar](https://github.com/azurejoga/osint-explorer/blob/master/src/components/Sidebar.jsx): `src/components/Sidebar.jsx`
- [Landing page](https://github.com/azurejoga/osint-explorer/blob/master/src/components/LandingPage.jsx): `src/components/LandingPage.jsx`
- [Grid cards](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolCard.jsx): `src/components/ToolCard.jsx`
- [List items](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolListItem.jsx): `src/components/ToolListItem.jsx`
- [Table view](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolTable.jsx): `src/components/ToolTable.jsx`
- [Tree view](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolTree.jsx): `src/components/ToolTree.jsx`
- [Compact view](https://github.com/azurejoga/osint-explorer/blob/master/src/components/ToolCompact.jsx): `src/components/ToolCompact.jsx`
- [Add tool dialog](https://github.com/azurejoga/osint-explorer/blob/master/src/components/AddToolModal.jsx): `src/components/AddToolModal.jsx`
- [Favorite control](https://github.com/azurejoga/osint-explorer/blob/master/src/components/FavoriteButton.jsx): `src/components/FavoriteButton.jsx`
- [Status badge](https://github.com/azurejoga/osint-explorer/blob/master/src/components/StatusBadge.jsx): `src/components/StatusBadge.jsx`

### Platform and metadata

- [SEO metadata](https://github.com/azurejoga/osint-explorer/blob/master/src/hooks/useSEO.js): `src/hooks/useSEO.js`
- [Favicon lookup](https://github.com/azurejoga/osint-explorer/blob/master/src/utils/favicon.js): `src/utils/favicon.js`
- [Electron host](https://github.com/azurejoga/osint-explorer/blob/master/electron/main.js): `electron/main.js`
- [Android host](https://github.com/azurejoga/osint-explorer/blob/master/android/app/src/main/java/com/osint/tools/MainActivity.java): `android/app/src/main/java/com/osint/tools/MainActivity.java`

### Other components

- **Investigator**
- **awesome-osint README**
- **Google favicon service**

## Connections

- Investigator → App shell: uses (evidence: `README.md`)
- App shell → App state: provides state (evidence: `src/App.jsx`)
- App shell → Navigation controls: renders (evidence: `src/App.jsx`)
- App shell → Category sidebar: renders (evidence: `src/App.jsx`)
- App shell → Landing page: renders (evidence: `src/App.jsx`)
- App shell → Grid cards: renders (evidence: `src/App.jsx`)
- App shell → List items: renders (evidence: `src/App.jsx`)
- App shell → Table view: renders (evidence: `src/App.jsx`)
- App shell → Tree view: renders (evidence: `src/App.jsx`)
- App shell → Compact view: renders (evidence: `src/App.jsx`)
- App shell → SEO metadata: updates metadata (evidence: `src/App.jsx`)
- App state → Tool loader: loads tools (evidence: `src/context/AppContext.jsx`)
- App state → Translations: localizes state (evidence: `src/context/AppContext.jsx`)
- Tool loader → Bundled catalog: fetches catalog (evidence: `src/hooks/useToolsLoader.js`)
- Tool loader → awesome-osint README: fetches and merges (evidence: `src/hooks/useToolsLoader.js`)
- Tool loader → Markdown parser: parses Markdown (evidence: `src/hooks/useToolsLoader.js`)
- Tool loader → Browser cache: reads and writes (evidence: `src/hooks/useToolsLoader.js`)
- App state → Browser cache: persists preferences (evidence: `src/context/AppContext.jsx`)
- Category sidebar → App state: sets filters (evidence: `src/components/Sidebar.jsx`)
- Category sidebar → Category metadata: uses categories (evidence: `src/components/Sidebar.jsx`)
- Navigation controls → App state: controls settings (evidence: `src/components/Header.jsx`)
- Add tool dialog → App state: updates catalog (evidence: `src/components/AddToolModal.jsx`)
- Grid cards → Status badge: renders status (evidence: `src/components/ToolCard.jsx`)
- Grid cards → Favorite control: renders control (evidence: `src/components/ToolCard.jsx`)
- Table view → Status badge: renders status (evidence: `src/components/ToolTable.jsx`)
- Table view → Favorite control: renders control (evidence: `src/components/ToolTable.jsx`)
- Tree view → Status badge: renders status (evidence: `src/components/ToolTree.jsx`)
- Tree view → Favorite control: renders control (evidence: `src/components/ToolTree.jsx`)
- Grid cards → Category metadata: uses categories (evidence: `src/components/ToolCard.jsx`)
- Grid cards → Translations: localizes text (evidence: `src/components/ToolCard.jsx`)
- Grid cards → Favicon lookup: gets icon URL (evidence: `src/components/ToolCard.jsx`)
- Favicon lookup → Google favicon service: requests favicon (evidence: `src/utils/favicon.js`)
- Table view → Favicon lookup: gets icon URL (evidence: `src/components/ToolTable.jsx`)
- Electron host → App shell: hosts app (evidence: `README.md`)
- Android host → App shell: hosts app (evidence: `README.md`)
