How azurejoga/osint-explorer works
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: App.jsx App shell · AppContext.jsx App state · ToolCard.jsx Grid cards · useToolsLoader.js Tool loader
Components 26
Catalog data
- Tool loader
src/hooks/useToolsLoader.js - Markdown parser
src/utils/parseMd.js - Bundled catalog
- Category metadata
src/data/categories.js - Translations
src/data/i18n.js
Application state
- App state
src/context/AppContext.jsx - Browser cache
Explorer interface
- App shell
src/App.jsx - Navigation controls
src/components/Header.jsx - Category sidebar
src/components/Sidebar.jsx - Landing page
src/components/LandingPage.jsx - Grid cards
src/components/ToolCard.jsx - List items
src/components/ToolListItem.jsx - Table view
src/components/ToolTable.jsx - Tree view
src/components/ToolTree.jsx - Compact view
src/components/ToolCompact.jsx - Add tool dialog
src/components/AddToolModal.jsx - Favorite control
src/components/FavoriteButton.jsx - Status badge
src/components/StatusBadge.jsx
Platform and metadata
- SEO metadata
src/hooks/useSEO.js - Favicon lookup
src/utils/favicon.js - Electron host
electron/main.js - Android host
android/app/src/main/java/com/osint/tools/MainActivity.java
Other components
- Investigator
- awesome-osint README
- Google favicon service
Connections 35
- Investigator → App shell: uses
README.md - App shell → App state: provides state
src/App.jsx - App shell → Navigation controls: renders
src/App.jsx - App shell → Category sidebar: renders
src/App.jsx - App shell → Landing page: renders
src/App.jsx - App shell → Grid cards: renders
src/App.jsx - App shell → List items: renders
src/App.jsx - App shell → Table view: renders
src/App.jsx - App shell → Tree view: renders
src/App.jsx - App shell → Compact view: renders
src/App.jsx - App shell → SEO metadata: updates metadata
src/App.jsx - App state → Tool loader: loads tools
src/context/AppContext.jsx - App state → Translations: localizes state
src/context/AppContext.jsx - Tool loader → Bundled catalog: fetches catalog
src/hooks/useToolsLoader.js - Tool loader → awesome-osint README: fetches and merges
src/hooks/useToolsLoader.js - Tool loader → Markdown parser: parses Markdown
src/hooks/useToolsLoader.js - Tool loader → Browser cache: reads and writes
src/hooks/useToolsLoader.js - App state → Browser cache: persists preferences
src/context/AppContext.jsx - Category sidebar → App state: sets filters
src/components/Sidebar.jsx - Category sidebar → Category metadata: uses categories
src/components/Sidebar.jsx - Navigation controls → App state: controls settings
src/components/Header.jsx - Add tool dialog → App state: updates catalog
src/components/AddToolModal.jsx - Grid cards → Status badge: renders status
src/components/ToolCard.jsx - Grid cards → Favorite control: renders control
src/components/ToolCard.jsx - Table view → Status badge: renders status
src/components/ToolTable.jsx - Table view → Favorite control: renders control
src/components/ToolTable.jsx - Tree view → Status badge: renders status
src/components/ToolTree.jsx - Tree view → Favorite control: renders control
src/components/ToolTree.jsx - Grid cards → Category metadata: uses categories
src/components/ToolCard.jsx - Grid cards → Translations: localizes text
src/components/ToolCard.jsx - Grid cards → Favicon lookup: gets icon URL
src/components/ToolCard.jsx - Favicon lookup → Google favicon service: requests favicon
src/utils/favicon.js - Table view → Favicon lookup: gets icon URL
src/components/ToolTable.jsx - Electron host → App shell: hosts app
README.md - Android host → App shell: hosts app
README.md