Hooky

🪝 One-click webhook trigger with page context, template variables, and smart rules

---

✨ Features

• 🪝 Multiple webhook templates — create, edit, and manage named templates with URL, HTTP method, and key-value parameters

• 🔀 Template variables — dynamically inject page context into parameter values:

  Variable	Description
  {{page.url}}	Current page URL
  {{page.title}}	Page title
  {{page.selection}}	Selected text
  {{page.meta.description}}	Meta description
  {{page.meta.og:title}}	Open Graph title
  {{page.meta.og:description}}	Open Graph description
  {{page.meta.og:image}}	Open Graph image

• ⚡ Quick Send Rules — define rules based on page URL or title to automatically fire the right webhook; first match wins, fallback opens popup

• 📋 Context menu — right-click on any page to trigger webhooks from the "Hooky" menu

• 🎨 Themes — system / light / dark

• 🌐 i18n — 10 languages: English, 简体中文, 繁體中文, 日本語, 한국어, Français, Deutsch, Español, Português (BR), Русский

🚀 Getting Started

Prerequisites

• Bun v1.x+
• Google Chrome

Install

bun install

The prepare script automatically runs husky to set up Git hooks.

Load in Chrome

1. Navigate to chrome://extensions/
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked → select the project root

---

🛠️ Development

Scripts

Command	What it does
bun run test	🧪 Run unit tests (Vitest)
bun run test:watch	👀 Run tests in watch mode
bun run test:coverage	📊 Run tests with V8 coverage report (90% threshold)
bun run lint	🔍 Lint src/ and tests/ with ESLint
bun run test:e2e	🌐 Run Puppeteer E2E tests
bun run build	📦 Package extension into dist/hooky-<version>.zip

Git Hooks (Husky) 🐶

Hooks live in .husky/ and are shared across the team via Git.

Stage	Command	Purpose
pre-commit	bun run test	✅ Catch regressions before commit
pre-push	bun run test && bun run lint	✅ Full quality gate before push

Test Coverage 📊

Coverage is enforced at 90% for all four metrics:

-----------------|---------|----------|---------|---------|
File             | % Stmts | % Branch | % Funcs | % Lines |
-----------------|---------|----------|---------|---------|
All files        |   96.83 |    91.55 |   94.78 |   98.48 |
-----------------|---------|----------|---------|---------|

Project Structure 📁

hooky/
├── 🌐 _locales/           # i18n messages (10 languages)
├── 🖼️ assets/              # Logo, store descriptions, promo images
├── 🐶 .husky/             # Git hooks (pre-commit, pre-push)
├── 🔧 scripts/            # Utility scripts (icon generation)
├── 📦 src/
│   ├── background.js      # Service worker — startup, rules dispatch
│   ├── contextmenu.js     # Context menu setup & click handling
│   ├── i18n.js            # i18n helpers (applyI18n, t)
│   ├── icons/             # Extension icons (16–256px)
│   ├── options/           # ⚙️ Settings page (HTML, CSS, JS)
│   ├── pagecontext.js     # Page metadata extraction (injected on demand)
│   ├── params.js          # Request body / URL builder
│   ├── popup/             # 🪟 Toolbar popup (HTML, CSS, JS)
│   ├── quicksend.js       # ⚡ Quick Send with badge feedback
│   ├── rules.js           # 📐 Rule engine (matchRule, findMatchingRule)
│   ├── store.js           # Storage CRUD, migration, settings
│   ├── template.js        # Template variable resolution engine
│   ├── theme.js           # 🎨 Theme switching (system/light/dark)
│   └── webhook.js         # HTTP request executor
├── 🧪 tests/
│   ├── *.test.js          # Unit tests (Vitest + jsdom)
│   └── e2e/               # Puppeteer E2E tests
├── manifest.json          # Chrome Extension Manifest V3
├── vitest.config.js       # Vitest + coverage config
├── eslint.config.mjs      # ESLint flat config
└── package.json           # Scripts & dev dependencies

---

📦 Publishing to Chrome Web Store

Build

bun run build

This produces dist/hooky-<version>.zip containing only the runtime files needed by Chrome.

Store Assets

Asset	Location	Status
📝 Description (EN)	assets/description-en.txt	✅
📝 Description (ZH)	assets/description-zh.txt	✅
📝 Description (JA)	assets/description-ja.txt	✅
📝 Description (KO)	assets/description-ko.txt	✅
📝 Description (ZH-TW)	assets/description-zh-tw.txt	✅
📝 Description (FR)	assets/description-fr.txt	✅
📝 Description (DE)	assets/description-de.txt	✅
📝 Description (ES)	assets/description-es.txt	✅
📝 Description (PT-BR)	assets/description-pt-br.txt	✅
📝 Description (RU)	assets/description-ru.txt	✅
🔒 Privacy Policy	PRIVACY.md	✅
🖼️ Store Icon (128×128)	src/icons/icon128.png	✅
🖼️ Promo Tile (440×280)	assets/hooky-banner-440x280.png	✅
📸 Screenshots (1280×800)	assets/hooky-screenshot-1280x800-*.png	✅

Steps

1. Register at the Chrome Web Store Developer Dashboard ($5 one-time fee)
2. Run bun run build to generate the ZIP
3. Upload dist/hooky-<version>.zip
4. Fill in listing details using the descriptions in assets/
5. Set privacy policy URL to https://github.com/nocoo/hooky/blob/main/PRIVACY.md
6. Upload promo tile (440×280) and at least 1 screenshot (1280×800 or 640×400)
7. Submit for review (typically 1–3 business days)

---

📄 License

MIT