all work

Cantonese–Mandarin Cross-Reference for Learners

  • JavaScript
  • Jyutping
  • Language Education

A lightweight learning tool for comparing Cantonese and Mandarin readings side by side. It turns HKEdU correspondence data into a learner-facing lookup path with Jyutping, recorded audio, and a mobile-friendly interface.

Open live site View code

At a glance

Role Sole builder and learning-tool designer

Problem

Cantonese learners often have to jump between dense correspondence tables, romanization notes, and audio sources to understand how a Mandarin reading maps to Cantonese.

Solution

I turned the correspondence data into a fast learner-facing lookup path with character search, Mandarin-to-Cantonese mapping, Jyutping, recorded audio, simplified/traditional switching, and mobile support.

Impact

Open-source learner tool · Cantonese-Mandarin lookup · Jyutping and recorded audio

Technical evidence

  • Vanilla JavaScript web tool built on HKEdU's correspondence table, with my own Jyutping conversion, recorded audio, and a fast mobile-friendly lookup UI for learners

What it does

The tool cross-references Cantonese and Mandarin readings in a fast lookup UI. The underlying initials/finals/tones correspondence comes from Hong Kong Education University; I added Jyutping conversion, recorded audio, and the mobile interface. The educational value is practical: a learner can move from a Mandarin reading to Cantonese sound structure without getting lost in a reference table.

Screenshots

Cantonese-Mandarin cross-reference tool usage instructions explaining lookup modes and features
The usage guide explains bidirectional lookup, character search, audio playback, and script switching.
Cantonese-Mandarin cross-reference tool showing a character lookup result with Jyutping and audio
Learner-facing lookup from a Chinese character to Cantonese and Mandarin readings.
Mobile view of the Cantonese-Mandarin cross-reference tool showing a character lookup result
The same lookup flow is usable on mobile.
Desktop view of the Cantonese-Mandarin cross-reference tool with Mandarin initial c selected
Selecting a Mandarin initial on desktop reveals the corresponding Cantonese initials and example characters.