Chrome extension project

Jev Browse

This repository holds a Manifest V3 browser extension, not a website. The extension lives in the extension/ folder: a content script with a floating sidebar, an MV3 service worker that holds the API keys, plus popup and options pages.

Install into Chrome — no coding needed

Download the ready-built extension, unzip it, and load it into Chrome.

  1. 1Click the “Download extension (.zip)” button above
  2. 2Unzip the downloaded file anywhere you like (right-click → Extract All)
  3. 3Open chrome://extensions in Chrome
  4. 4Turn on Developer mode (top-right toggle)
  5. 5Click “Load unpacked” and select the unzipped folder
  6. 6Pin Jev Browse, then reload any web page once

Or build it yourself (optional, needs Node.js)

For development — if you want to edit the source code first.

  1. 1cd extension && npm install && npm run build
  2. 2Open chrome://extensions in Chrome
  3. 3Turn on Developer mode (top-right toggle)
  4. 4Click “Load unpacked” and select extension/dist
  5. 5Pin Jev Browse, then reload any web page once

Update after changes

Unpacked extensions don't update themselves — Chrome loads a frozen copy. Whenever Jev makes a change:

  1. 1Come back to this page and click “Download extension (.zip)” again
  2. 2Unzip it (replacing the old folder or extracting alongside it)
  3. 3chrome://extensions → click the reload arrow on the Jev Browse card
  4. 4If you changed the folder, “Load unpacked” again with the new folder
  5. 5Reload the web page you are testing on

Developers who build locally instead: run npm run build (or keep npm run dev watching), then reload the card and the page.

Keep it in sync with GitHub

Connect the project once and every change is pushed to your repository automatically.

  1. 1Lovable editor → Plus (+) menu → GitHub → Connect project
  2. 2Every change made here is committed to your repository automatically
  3. 3On your machine: git pull, npm install, npm run build, then reload the extension in Chrome

Test it

Quick smoke test — the full 14-step checklist is at the end of extension/ARCHITECTURE.md.

  1. 1Open a news article — the floating j button appears bottom-right; click it to open the panel
  2. 2Page tab → Clean hides banners and ads; Original restores the page exactly
  3. 3Click a comment box, type a sloppy sentence, press Alt+J, confirm — the text is replaced
  4. 4Select a paragraph → the bubble appears → Explain (needs a provider in Settings → Providers)

Read extension/README.md for features and the security model, and extension/ARCHITECTURE.md for the messaging design and the manual test checklist.