# vistaratech/aoogle architecture

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

- Interactive diagram: https://gitdiagram.com/vistaratech/aoogle
- Repository: https://github.com/vistaratech/aoogle

## Overview

Aoogle is a task-oriented AI-tool discovery search engine. A user enters a task by text or voice, explores suggestions or categories, and submits a search; the app ranks its curated tool index, applies category and pricing filters, and can fetch live web discoveries before presenting recommendations and result cards. Major branches also include the AI decision guide, community submissions, and persistent theme preferences. The README documents these capabilities; unsampled implementation details are represented only where documented, and unverified wiring is omitted.

Main entry points: [`src/App.jsx`](https://github.com/vistaratech/aoogle/blob/main/src/App.jsx) (Search controller), [`src/components/SearchBar.jsx`](https://github.com/vistaratech/aoogle/blob/main/src/components/SearchBar.jsx) (Search input), [`src/lib/webSearch.js`](https://github.com/vistaratech/aoogle/blob/main/src/lib/webSearch.js) (Live web discovery), [`src/components/SubmitToolModal.jsx`](https://github.com/vistaratech/aoogle/blob/main/src/components/SubmitToolModal.jsx) (Tool submission form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Search experience"]
  node_searchbar["Search input<br/>[SearchBar.jsx]"]
  node_searchheader["Results header<br/>[SearchHeader.jsx]"]
  node_trending["Trending tasks<br/>[TrendingChips.jsx]"]
  node_categories["Category explorer<br/>[CategoryIcons.jsx]"]
  node_theme["Theme toggle<br/>[ThemeToggle.jsx]"]
  node_webresults["Web results shelf"]
  node_resultcard["Tool result card<br/>[ResultCard.jsx]"]
end

subgraph group_discovery["Discovery and ranking"]
  node_toolindex[("Curated tool index<br/>[tools.js]")]
  node_ranker["Task relevance scorer<br/>[search.js]"]
  node_decision["AI decision guide"]
  node_decisionlogic["Recommendation logic<br/>[aiDecision.js]"]
  node_websearch["Live web discovery<br/>[webSearch.js]"]
end

subgraph group_community["Community tools"]
  node_submitmodal["Tool submission form"]
  node_browserstorage[("Browser local storage")]
end

subgraph group_runtime["App runtime"]
  node_app["Search controller<br/>[App.jsx]"]
  node_mount["React mount<br/>[main.jsx]"]
  node_error["Error boundary<br/>[ErrorBoundary.jsx]"]
  node_webworker["Web search worker<br/>[worker.js]"]
end

node_user(("Search user"))
node_websources(("Web search sources"))

node_user -->|"enters query"| node_searchbar
node_searchbar -->|"submits query"| node_app
node_app -->|"renders"| node_searchbar
node_app -->|"renders"| node_searchheader
node_searchheader -->|"renders"| node_searchbar
node_app -->|"renders"| node_trending
node_app -->|"renders"| node_categories
node_app -->|"renders"| node_theme
node_user -->|"chooses task"| node_trending
node_user -->|"chooses category"| node_categories
node_app -->|"ranks tools"| node_ranker
node_app -->|"uses tool data"| node_toolindex
node_app -->|"renders matches"| node_resultcard
node_app -->|"renders guide"| node_decision
node_decision -->|"gets verdicts"| node_decisionlogic
node_app -->|"fetches discoveries"| node_websearch
node_websearch -->|"queries sources"| node_websources
node_websearch -.->|"requests API"| node_webworker
node_app -->|"renders discoveries"| node_webresults
node_app -->|"opens form"| node_submitmodal
node_submitmodal -->|"submits tool"| node_app
node_submitmodal -.->|"caches submission"| node_browserstorage
node_app -.->|"persists theme"| node_browserstorage
node_mount -->|"wraps app"| node_error
node_mount -->|"mounts"| node_app

click node_app "https://github.com/vistaratech/aoogle/blob/main/src/App.jsx"
click node_mount "https://github.com/vistaratech/aoogle/blob/main/src/main.jsx"
click node_error "https://github.com/vistaratech/aoogle/blob/main/src/components/ErrorBoundary.jsx"
click node_searchbar "https://github.com/vistaratech/aoogle/blob/main/src/components/SearchBar.jsx"
click node_searchheader "https://github.com/vistaratech/aoogle/blob/main/src/components/SearchHeader.jsx"
click node_trending "https://github.com/vistaratech/aoogle/blob/main/src/components/TrendingChips.jsx"
click node_categories "https://github.com/vistaratech/aoogle/blob/main/src/components/CategoryIcons.jsx"
click node_theme "https://github.com/vistaratech/aoogle/blob/main/src/components/ThemeToggle.jsx"
click node_toolindex "https://github.com/vistaratech/aoogle/blob/main/src/data/tools.js"
click node_ranker "https://github.com/vistaratech/aoogle/blob/main/src/lib/search.js"
click node_decision "https://github.com/vistaratech/aoogle/blob/main/src/components/AiDecisionGuide.jsx"
click node_decisionlogic "https://github.com/vistaratech/aoogle/blob/main/src/lib/aiDecision.js"
click node_websearch "https://github.com/vistaratech/aoogle/blob/main/src/lib/webSearch.js"
click node_webworker "https://github.com/vistaratech/aoogle/blob/main/src/worker.js"
click node_webresults "https://github.com/vistaratech/aoogle/blob/main/src/components/WebSearchResults.jsx"
click node_resultcard "https://github.com/vistaratech/aoogle/blob/main/src/components/ResultCard.jsx"
click node_submitmodal "https://github.com/vistaratech/aoogle/blob/main/src/components/SubmitToolModal.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_searchbar,node_searchheader,node_trending,node_categories,node_theme,node_webresults,node_resultcard,node_user toneBlue
class node_toolindex,node_ranker,node_decision,node_decisionlogic,node_websearch toneAmber
class node_submitmodal,node_browserstorage toneMint
class node_app,node_mount,node_error,node_webworker toneRose
class node_websources toneIndigo
```

## Components

### Search experience

- [Search input](https://github.com/vistaratech/aoogle/blob/main/src/components/SearchBar.jsx): `src/components/SearchBar.jsx`
- [Results header](https://github.com/vistaratech/aoogle/blob/main/src/components/SearchHeader.jsx): `src/components/SearchHeader.jsx`
- [Trending tasks](https://github.com/vistaratech/aoogle/blob/main/src/components/TrendingChips.jsx): `src/components/TrendingChips.jsx`
- [Category explorer](https://github.com/vistaratech/aoogle/blob/main/src/components/CategoryIcons.jsx): `src/components/CategoryIcons.jsx`
- [Theme toggle](https://github.com/vistaratech/aoogle/blob/main/src/components/ThemeToggle.jsx): `src/components/ThemeToggle.jsx`
- [Web results shelf](https://github.com/vistaratech/aoogle/blob/main/src/components/WebSearchResults.jsx): `src/components/WebSearchResults.jsx`
- [Tool result card](https://github.com/vistaratech/aoogle/blob/main/src/components/ResultCard.jsx): `src/components/ResultCard.jsx`

### Discovery and ranking

- [Curated tool index](https://github.com/vistaratech/aoogle/blob/main/src/data/tools.js): `src/data/tools.js`
- [Task relevance scorer](https://github.com/vistaratech/aoogle/blob/main/src/lib/search.js): `src/lib/search.js`
- [AI decision guide](https://github.com/vistaratech/aoogle/blob/main/src/components/AiDecisionGuide.jsx): `src/components/AiDecisionGuide.jsx`
- [Recommendation logic](https://github.com/vistaratech/aoogle/blob/main/src/lib/aiDecision.js): `src/lib/aiDecision.js`
- [Live web discovery](https://github.com/vistaratech/aoogle/blob/main/src/lib/webSearch.js): `src/lib/webSearch.js`

### Community tools

- [Tool submission form](https://github.com/vistaratech/aoogle/blob/main/src/components/SubmitToolModal.jsx): `src/components/SubmitToolModal.jsx`
- **Browser local storage**

### App runtime

- [Search controller](https://github.com/vistaratech/aoogle/blob/main/src/App.jsx): `src/App.jsx`
- [React mount](https://github.com/vistaratech/aoogle/blob/main/src/main.jsx): `src/main.jsx`
- [Error boundary](https://github.com/vistaratech/aoogle/blob/main/src/components/ErrorBoundary.jsx): `src/components/ErrorBoundary.jsx`
- [Web search worker](https://github.com/vistaratech/aoogle/blob/main/src/worker.js): `src/worker.js`

### Other components

- **Search user**
- **Web search sources**

## Connections

- Search user → Search input: enters query (evidence: `src/components/SearchBar.jsx`)
- Search input → Search controller: submits query (evidence: `src/App.jsx`)
- Search controller → Search input: renders (evidence: `src/App.jsx`)
- Search controller → Results header: renders (evidence: `src/App.jsx`)
- Results header → Search input: renders (evidence: `src/components/SearchHeader.jsx`)
- Search controller → Trending tasks: renders (evidence: `src/App.jsx`)
- Search controller → Category explorer: renders (evidence: `src/App.jsx`)
- Search controller → Theme toggle: renders (evidence: `src/App.jsx`)
- Search user → Trending tasks: chooses task
- Search user → Category explorer: chooses category
- Search controller → Task relevance scorer: ranks tools (evidence: `src/App.jsx`)
- Search controller → Curated tool index: uses tool data (evidence: `src/App.jsx`)
- Search controller → Tool result card: renders matches (evidence: `src/App.jsx`)
- Search controller → AI decision guide: renders guide (evidence: `src/App.jsx`)
- AI decision guide → Recommendation logic: gets verdicts (evidence: `src/components/AiDecisionGuide.jsx`)
- Search controller → Live web discovery: fetches discoveries (evidence: `src/App.jsx`)
- Live web discovery → Web search sources: queries sources (evidence: `src/lib/webSearch.js`)
- Live web discovery → Web search worker: requests API
- Search controller → Web results shelf: renders discoveries (evidence: `src/App.jsx`)
- Search controller → Tool submission form: opens form (evidence: `src/App.jsx`)
- Tool submission form → Search controller: submits tool (evidence: `src/App.jsx`)
- Tool submission form → Browser local storage: caches submission
- Search controller → Browser local storage: persists theme
- React mount → Error boundary: wraps app (evidence: `src/main.jsx`)
- React mount → Search controller: mounts (evidence: `src/main.jsx`)
