# kartikbhosle/trustguard architecture

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

## Overview

TrustGuard is a Chrome extension that watches password fields, waits for typing to pause, checks passwords against HIBP using a locally computed SHA-1 prefix/suffix query, then displays a safe or breached status. The graph separates page-field discovery, privacy-preserving lookup, and user feedback. The README documents manifest and styling capabilities; source excerpts show the central runtime behavior, but not every implementation detail.

Main entry points: [`content.js`](https://github.com/kartikbhosle/trustguard/blob/main/content.js) (Input Debounce), [`manifest.json`](https://github.com/kartikbhosle/trustguard/blob/main/manifest.json) (Extension Config), [`style.css`](https://github.com/kartikbhosle/trustguard/blob/main/style.css) (Tooltip Styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Field Discovery"]
  node_page_fields["Password Fields"]
  node_extension_config["Extension Config<br/>[manifest.json]"]
  node_field_monitor["Field Monitor<br/>[content.js]"]
  node_input_debounce["Input Debounce<br/>[content.js]"]
end

subgraph group_checking["Privacy Check"]
  node_secure_guard["Secure Context Guard<br/>[content.js]"]
  node_local_hash["Local SHA-1<br/>[content.js]"]
  node_range_lookup["Range Lookup<br/>[content.js]"]
  node_suffix_match["Suffix Matching<br/>[content.js]"]
end

subgraph group_feedback["User Feedback"]
  node_status_tooltip["Status Tooltip<br/>[content.js]"]
  node_tooltip_style["Tooltip Styling<br/>[style.css]"]
end

node_user(("Website User"))
node_hibp["HIBP API"]

node_user -->|"enters password"| node_page_fields
node_extension_config -->|"configures script"| node_field_monitor
node_field_monitor -->|"scans and observes"| node_page_fields
node_field_monitor -->|"binds input handler"| node_input_debounce
node_input_debounce -->|"checks context"| node_secure_guard
node_input_debounce -->|"checks password"| node_local_hash
node_local_hash -->|"provides hash"| node_range_lookup
node_range_lookup -->|"requests prefix range"| node_hibp
node_range_lookup -->|"matches response"| node_suffix_match
node_input_debounce -->|"shows breach count"| node_status_tooltip
node_status_tooltip -->|"uses overlay styles"| node_tooltip_style

click node_extension_config "https://github.com/kartikbhosle/trustguard/blob/main/manifest.json"
click node_field_monitor "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_input_debounce "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_secure_guard "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_local_hash "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_range_lookup "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_suffix_match "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_status_tooltip "https://github.com/kartikbhosle/trustguard/blob/main/content.js"
click node_tooltip_style "https://github.com/kartikbhosle/trustguard/blob/main/style.css"

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_page_fields,node_extension_config,node_field_monitor,node_input_debounce,node_user toneBlue
class node_secure_guard,node_local_hash,node_range_lookup,node_suffix_match toneAmber
class node_status_tooltip,node_tooltip_style,node_hibp toneMint
```

## Components

### Field Discovery

- **Password Fields**
- [Extension Config](https://github.com/kartikbhosle/trustguard/blob/main/manifest.json): `manifest.json`
- [Field Monitor](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`
- [Input Debounce](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`

### Privacy Check

- [Secure Context Guard](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`
- [Local SHA-1](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`
- [Range Lookup](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`
- [Suffix Matching](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`

### User Feedback

- [Status Tooltip](https://github.com/kartikbhosle/trustguard/blob/main/content.js): `content.js`
- [Tooltip Styling](https://github.com/kartikbhosle/trustguard/blob/main/style.css): `style.css`

### Other components

- **Website User**
- **HIBP API**

## Connections

- Website User → Password Fields: enters password (evidence: `README.md`)
- Extension Config → Field Monitor: configures script (evidence: `README.md`)
- Field Monitor → Password Fields: scans and observes (evidence: `content.js`)
- Field Monitor → Input Debounce: binds input handler (evidence: `content.js`)
- Input Debounce → Secure Context Guard: checks context (evidence: `content.js`)
- Input Debounce → Local SHA-1: checks password (evidence: `content.js`)
- Local SHA-1 → Range Lookup: provides hash (evidence: `content.js`)
- Range Lookup → HIBP API: requests prefix range (evidence: `content.js`)
- Range Lookup → Suffix Matching: matches response (evidence: `content.js`)
- Input Debounce → Status Tooltip: shows breach count (evidence: `content.js`)
- Status Tooltip → Tooltip Styling: uses overlay styles (evidence: `README.md`)
