YomiHover: Japanese Kanji Pronunciation Helper

About

# Chrome Web Store Listing Description — YomiHover

This document contains the official metadata and description for YomiHover (Kanji Pronunciation Assistant) to be copy-pasted directly into the Chrome Developer Dashboard when publishing the extension.

---

## 1. Store Listing Metadata

- **Extension Name**: YomiHover: Japanese Kanji Pronunciation Helper
- **Summary (Single-line Description)**: Hover over any Japanese Kanji to instantly see its Onyomi, Kunyomi, Romaji, and example words in a beautiful card.
- **Category**: Productivity / Education / Developer Tools
- **Language**: English (United States)
- **Icons**: (Refer to `assets/icon.png` in the project repository. It contains the high-resolution base icon which is auto-resized by WXT into 16px, 32px, 48px, and 128px for Chrome store delivery).

---

## 2. Detailed Description (CWS Dashboard Copy)

### 🚀 Instantly Master Japanese Readings on Any Webpage!

Have you ever stumbled upon a Japanese webpage and struggled to figure out how to pronounce a specific Kanji character? Standard dictionaries make you copy-paste words back and forth, breaking your reading flow. 

**YomiHover** is a minimalist, local-first browser extension that helps you effortlessly scan and read Japanese Kanji without leaving the page. Simply hover over any Kanji to instantly see its standard Onyomi (音読み) and Kunyomi (訓読み) readings, complete with helpful Romaji and example compound words.

---

### ✨ Key Features

- **⚡ Instant Hover Cards**: Simply rest your mouse pointer on any Japanese Kanji, and a sleek translucent card will pop up after a comfortable 200ms delay.
- **🏷️ Smart Onyomi & Kunyomi Badging**: Readings are clearly color-coded (Indigo for Onyomi "音", Emerald for Kunyomi "訓") so you can easily distinguish Chinese-derived readings from native Japanese readings.
- **🔤 Automatic Romaji Transcription**: Learn exactly how to pronounce Hiragana and Katakana readings with accurate English Romaji guide maps.
- **🛡️ local-First & Privacy-Focused**: The extension carries its database locally. There are ZERO external network/API requests, meaning it works 100% offline and never tracks your browsing history.
- **🔗 Bulletproof Elements & Link Compatibility**: Custom event capture technology ensures the hover tooltips work flawlessly inside links (`<a>`), tables, complex interactive elements, and dynamic pages (SPAs).
- **🎨 Premium minimalist Aesthetics**: Features a modern glassmorphic card design supporting dark mode, fitting seamlessly into any webpage layout.

---

### 📖 How to Use

1. Click the WXT-powered extension icon after installation to ensure it is active.
2. Visit any Japanese website (e.g. Japanese Wikipedia, NHK News, or your favorite blog).
3. Hover your mouse cursor over any Kanji character. 
4. Read the pronunciation cards and continue your reading flow seamlessly!

---

### 🛠️ Technical Implementation Notes

- Powered by **WXT** and **React 18** for zero lag and maximum efficiency.
- Uses Shadow DOM style-isolation so that the host page's stylesheet never messes up the card layout.
- Employs low-overhead `TreeWalker` text nodes scanning and event capturing (`useCapture: true`) to ensure zero main-thread blockage and maximum compatibility on heavily-scripted websites.