# nivetha-natarajan/techfusion architecture

> Architecture diagram of the GitHub repository nivetha-natarajan/techfusion, 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/nivetha-natarajan/techfusion
- Repository: https://github.com/nivetha-natarajan/techfusion

## Overview

TechFusion’s root README gives no product detail; the source identifies HackTrack as a Chrome extension for following topics through Gmail and displaying extracted upcoming opportunities as sticky-note cards. The main workflow is: enter a topic, have the background worker search Gmail and analyze matching messages with Gemini, then persist and display the results. Background sync, authentication, prioritization, and card interactions are also represented. Evidence is limited to the provided excerpts and their SOURCE INDEX references; other wiring is left out.

Main entry points: [`hacktrack-extension/src/sidepanel/App.jsx`](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/App.jsx) (Dashboard), [`hacktrack-extension/src/background/background.js`](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/background/background.js) (Service worker), [`hacktrack-extension/src/shared/storage.js`](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/storage.js) (Storage helper), [`hacktrack-extension/src/sidepanel/components/CardList.jsx`](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/CardList.jsx) (Card feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Side Panel"]
  node_app["Dashboard<br/>[App.jsx]"]
  node_follow["Topic input<br/>[FollowInput.jsx]"]
  node_login["Login button<br/>[LoginButton.jsx]"]
  node_cards["Card feed<br/>[CardList.jsx]"]
  node_note["Opportunity notes<br/>[StickyNoteCard.jsx]"]
  node_entry["Panel entry<br/>[main.jsx]"]
end

subgraph group_worker["Background Processing"]
  node_workerjs["Service worker<br/>[background.js]"]
end

subgraph group_services["External Services"]
  node_gmail["Gmail client<br/>[gmailApi.js]"]
  node_gemini["Gemini analysis<br/>[geminiApi.js]"]
  node_gmailservice["Gmail API"]
  node_geminiservice["Gemini API"]
end

subgraph group_state["Extension State"]
  node_storage["Storage helper<br/>[storage.js]"]
  node_localstore[("Chrome local storage")]
end

node_user(("Extension user"))

node_user -.->|"uses"| node_app
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_follow
node_app -->|"renders"| node_login
node_app -->|"renders"| node_cards
node_cards -->|"renders"| node_note
node_app -->|"sends topic actions"| node_workerjs
node_app -->|"reads and writes topics"| node_storage
node_workerjs -->|"searches messages"| node_gmail
node_workerjs -->|"analyzes emails"| node_gemini
node_workerjs -->|"loads and saves topics"| node_storage
node_gmail -->|"fetches messages"| node_gmailservice
node_gemini -->|"requests extraction"| node_geminiservice
node_storage -->|"reads and writes"| node_localstore

click node_app "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/App.jsx"
click node_follow "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/FollowInput.jsx"
click node_login "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/LoginButton.jsx"
click node_cards "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/CardList.jsx"
click node_note "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/StickyNoteCard.jsx"
click node_workerjs "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/background/background.js"
click node_gmail "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/gmailApi.js"
click node_gemini "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/geminiApi.js"
click node_storage "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/storage.js"
click node_entry "https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/main.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_follow,node_login,node_cards,node_note,node_entry,node_user toneBlue
class node_workerjs toneAmber
class node_gmail,node_gemini,node_gmailservice,node_geminiservice toneMint
class node_storage,node_localstore toneRose
```

## Components

### Side Panel

- [Dashboard](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/App.jsx): `hacktrack-extension/src/sidepanel/App.jsx`
- [Topic input](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/FollowInput.jsx): `hacktrack-extension/src/sidepanel/components/FollowInput.jsx`
- [Login button](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/LoginButton.jsx): `hacktrack-extension/src/sidepanel/components/LoginButton.jsx`
- [Card feed](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/CardList.jsx): `hacktrack-extension/src/sidepanel/components/CardList.jsx`
- [Opportunity notes](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/components/StickyNoteCard.jsx): `hacktrack-extension/src/sidepanel/components/StickyNoteCard.jsx`
- [Panel entry](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/sidepanel/main.jsx): `hacktrack-extension/src/sidepanel/main.jsx`

### Background Processing

- [Service worker](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/background/background.js): `hacktrack-extension/src/background/background.js`

### External Services

- [Gmail client](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/gmailApi.js): `hacktrack-extension/src/shared/gmailApi.js`
- [Gemini analysis](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/geminiApi.js): `hacktrack-extension/src/shared/geminiApi.js`
- **Gmail API**
- **Gemini API**

### Extension State

- [Storage helper](https://github.com/nivetha-natarajan/techfusion/blob/main/hacktrack-extension/src/shared/storage.js): `hacktrack-extension/src/shared/storage.js`
- **Chrome local storage**

### Other components

- **Extension user**

## Connections

- Extension user → Dashboard: uses
- Panel entry → Dashboard: renders (evidence: `hacktrack-extension/src/sidepanel/main.jsx`)
- Dashboard → Topic input: renders (evidence: `hacktrack-extension/src/sidepanel/App.jsx`)
- Dashboard → Login button: renders (evidence: `hacktrack-extension/src/sidepanel/App.jsx`)
- Dashboard → Card feed: renders (evidence: `hacktrack-extension/src/sidepanel/App.jsx`)
- Card feed → Opportunity notes: renders (evidence: `hacktrack-extension/src/sidepanel/components/CardList.jsx`)
- Dashboard → Service worker: sends topic actions (evidence: `hacktrack-extension/src/sidepanel/App.jsx`)
- Dashboard → Storage helper: reads and writes topics (evidence: `hacktrack-extension/src/sidepanel/App.jsx`)
- Service worker → Gmail client: searches messages (evidence: `hacktrack-extension/src/background/background.js`)
- Service worker → Gemini analysis: analyzes emails (evidence: `hacktrack-extension/src/background/background.js`)
- Service worker → Storage helper: loads and saves topics (evidence: `hacktrack-extension/src/background/background.js`)
- Gmail client → Gmail API: fetches messages (evidence: `hacktrack-extension/src/shared/gmailApi.js`)
- Gemini analysis → Gemini API: requests extraction (evidence: `hacktrack-extension/src/shared/geminiApi.js`)
- Storage helper → Chrome local storage: reads and writes (evidence: `hacktrack-extension/src/shared/storage.js`)
