# jia-hua-ren/linkedindeed architecture

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

- Interactive diagram: https://gitdiagram.com/jia-hua-ren/linkedindeed
- Repository: https://github.com/jia-hua-ren/linkedindeed

## Overview

LinkedIndeed is a Chrome extension that turns a supported job-post page into a configurable, tab-separated row for a user's Excel or Sheets tracker. The user opens a job post, opens the extension, reviews extracted details, configures export columns and date formats in Settings, then copies the row or cleaned job URL. The popup requests extraction from a content script, which detects the site and dispatches to a site-specific scraper. The README documents Indeed, LinkedIn and Greenhouse as supported; source also contains Ashby and ZipRecruiter scrapers. Edges reflect the shown popup/content messaging and scraper dispatch; storage and clipboard are browser-provided services.

Main entry points: [`content.js`](https://github.com/jia-hua-ren/linkedindeed/blob/main/content.js) (Content messaging), [`popup.js`](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js) (Popup workflow), [`jobsites/JobScraper.js`](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/JobScraper.js) (Scraper contract), [`popup.html`](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.html) (Extension popup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_popup["Popup and export"]
  node_popupui["Extension popup<br/>[popup.html]"]
  node_popuplogic["Popup workflow<br/>[popup.js]"]
  node_settings["Export settings<br/>[popup.js]"]
  node_rowexport["Row and URL copy<br/>[popup.js]"]
end

subgraph group_capture["Page capture"]
  node_urlcheck["URL detection<br/>[urlUtils.js]"]
  node_content["Content messaging<br/>[content.js]"]
end

subgraph group_scrapers["Site extraction"]
  node_base["Scraper contract<br/>[JobScraper.js]"]
  node_indeed["Indeed extraction<br/>[IndeedScraper.js]"]
  node_linkedin["LinkedIn extraction<br/>[LinkedInScraper.js]"]
  node_greenhouse["Greenhouse extraction"]
  node_ashby["Ashby extraction<br/>[AshbyScraper.js]"]
  node_ziprecruiter["ZipRecruiter extraction"]
end

subgraph group_browser["Browser services"]
  node_storage[("Chrome local storage")]
  node_clipboard["System clipboard"]
end

node_user(("Job seeker"))
node_jobpost["Job post page"]

node_user -->|"opens"| node_jobpost
node_user -->|"opens"| node_popupui
node_popupui -->|"loads"| node_popuplogic
node_popuplogic -->|"requests info"| node_content
node_popuplogic -->|"injects scripts"| node_urlcheck
node_content -->|"detects site"| node_urlcheck
node_content -->|"dispatches"| node_indeed
node_content -->|"dispatches"| node_linkedin
node_content -->|"dispatches"| node_greenhouse
node_content -->|"dispatches"| node_ashby
node_content -->|"dispatches"| node_ziprecruiter
node_indeed -->|"extends"| node_base
node_linkedin -->|"extends"| node_base
node_greenhouse -->|"extends"| node_base
node_ashby -->|"extends"| node_base
node_ziprecruiter -->|"extends"| node_base
node_content -->|"extracts details"| node_jobpost
node_content -->|"returns details"| node_popuplogic
node_popuplogic -->|"loads settings"| node_settings
node_settings -->|"reads and writes"| node_storage
node_popuplogic -->|"renders actions"| node_rowexport
node_rowexport -->|"copies text"| node_clipboard
node_user -->|"copies row"| node_rowexport

click node_popupui "https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.html"
click node_popuplogic "https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js"
click node_settings "https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js"
click node_rowexport "https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js"
click node_urlcheck "https://github.com/jia-hua-ren/linkedindeed/blob/main/urlUtils.js"
click node_content "https://github.com/jia-hua-ren/linkedindeed/blob/main/content.js"
click node_base "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/JobScraper.js"
click node_indeed "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/IndeedScraper.js"
click node_linkedin "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/LinkedInScraper.js"
click node_greenhouse "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/GreenhouseScraper.js"
click node_ashby "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/AshbyScraper.js"
click node_ziprecruiter "https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/ZipRecruiterScraper.js"

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_popupui,node_popuplogic,node_settings,node_rowexport toneBlue
class node_urlcheck,node_content toneAmber
class node_base,node_indeed,node_linkedin,node_greenhouse,node_ashby,node_ziprecruiter toneMint
class node_storage,node_clipboard toneRose
class node_user,node_jobpost toneIndigo
```

## Components

### Popup and export

- [Extension popup](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.html): `popup.html`
- [Popup workflow](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js): `popup.js`
- [Export settings](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js): `popup.js`
- [Row and URL copy](https://github.com/jia-hua-ren/linkedindeed/blob/main/popup.js): `popup.js`

### Page capture

- [URL detection](https://github.com/jia-hua-ren/linkedindeed/blob/main/urlUtils.js): `urlUtils.js`
- [Content messaging](https://github.com/jia-hua-ren/linkedindeed/blob/main/content.js): `content.js`

### Site extraction

- [Scraper contract](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/JobScraper.js): `jobsites/JobScraper.js`
- [Indeed extraction](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/IndeedScraper.js): `jobsites/IndeedScraper.js`
- [LinkedIn extraction](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/LinkedInScraper.js): `jobsites/LinkedInScraper.js`
- [Greenhouse extraction](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/GreenhouseScraper.js): `jobsites/GreenhouseScraper.js`
- [Ashby extraction](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/AshbyScraper.js): `jobsites/AshbyScraper.js`
- [ZipRecruiter extraction](https://github.com/jia-hua-ren/linkedindeed/blob/main/jobsites/ZipRecruiterScraper.js): `jobsites/ZipRecruiterScraper.js`

### Browser services

- **Chrome local storage**
- **System clipboard**

### Other components

- **Job seeker**
- **Job post page**

## Connections

- Job seeker → Job post page: opens (evidence: `README.md`)
- Job seeker → Extension popup: opens (evidence: `README.md`)
- Extension popup → Popup workflow: loads (evidence: `popup.js`)
- Popup workflow → Content messaging: requests info (evidence: `popup.js`)
- Popup workflow → URL detection: injects scripts (evidence: `popup.js`)
- Content messaging → URL detection: detects site (evidence: `content.js`)
- Content messaging → Indeed extraction: dispatches (evidence: `content.js`)
- Content messaging → LinkedIn extraction: dispatches (evidence: `content.js`)
- Content messaging → Greenhouse extraction: dispatches (evidence: `content.js`)
- Content messaging → Ashby extraction: dispatches (evidence: `content.js`)
- Content messaging → ZipRecruiter extraction: dispatches (evidence: `content.js`)
- Indeed extraction → Scraper contract: extends (evidence: `jobsites/IndeedScraper.js`)
- LinkedIn extraction → Scraper contract: extends (evidence: `jobsites/LinkedInScraper.js`)
- Greenhouse extraction → Scraper contract: extends (evidence: `jobsites/GreenhouseScraper.js`)
- Ashby extraction → Scraper contract: extends (evidence: `jobsites/AshbyScraper.js`)
- ZipRecruiter extraction → Scraper contract: extends (evidence: `jobsites/ZipRecruiterScraper.js`)
- Content messaging → Job post page: extracts details (evidence: `content.js`)
- Content messaging → Popup workflow: returns details (evidence: `content.js`)
- Popup workflow → Export settings: loads settings (evidence: `popup.js`)
- Export settings → Chrome local storage: reads and writes (evidence: `popup.js`)
- Popup workflow → Row and URL copy: renders actions (evidence: `popup.js`)
- Row and URL copy → System clipboard: copies text (evidence: `popup.js`)
- Job seeker → Row and URL copy: copies row (evidence: `README.md`)
