⚡ ePocket — Vocabulary Capture Chrome Extension

Your personal vocabulary pocket. Capture, define, and master new words as you browse the web.

Architecture

Rendering mermaid diagram...

Features

FeatureHow
Instant word explainSelect text → press Alt+E
Double-click explainDouble-click any word on page
Right-click explainRight-click selection → "ePocket: Explain…"
One-click saveClick "Save to Pocket" in the modal
Pocket dashboardClick extension icon → 📚 Pocket tab
Mastery tracking4 dots: New → Learning → Familiar → Mastered
Spaced review🧠 Review tab — flip cards with Again/Hard/Good/Easy
Search & sortSearch by word, sort by newest / A–Z / to review

Install the Chrome Extension

Step 1 — Download the extension files

Download these files from the extension/ folder in this val:

extension/
  manifest.json
  background.js
  content.js
  modal.css
  popup.html
  popup.js

You'll also need placeholder icon images (icon16.png, icon48.png, icon128.png) — any PNG files will work for development.

Step 2 — Load in Chrome

  1. Open Chrome → chrome://extensions
  2. Enable Developer mode (top right toggle)
  3. Click Load unpacked
  4. Select the extension/ folder

Step 3 — Use it!

  • Select any text on any webpage → press Alt+E
  • Or double-click a word
  • Or right-click → "ePocket: Explain…"
  • The modal pops up with the definition + context
  • Click "+ Save to Pocket" to remember it
  • Click the extension icon to browse your pocket and do flashcard reviews

API Endpoints

Base URL: https://v7er--6efc0554309f11f19d7e42dde27851f2.web.val.run

MethodPathDescription
POST/explain{ word, context } → definition
POST/wordsSave word to pocket
GET/words?q=&sort=List saved words
PATCH/words/:id/review{ mastery: 0-3 }
DELETE/words/:idRemove word
GET/statsLearning statistics

Mastery Levels

0 = New       (purple dot)
1 = Learning  (purple dot)
2 = Familiar  (purple dot)
3 = Mastered  (all dots filled — excluded from review)