## Project Overview

Gojuon Master is a personal project addressing a gap in Japanese language learning tools. While many apps help learners memorize hiragana and katakana characters individually, few emphasize the structural significance of the Gojuon (五十音) chart—the foundation of Japanese verb conjugation.

The project emerged from studying Japanese and realizing that understanding the column and row structure of the Gojuon makes verb conjugation patterns logical rather than arbitrary. For example, knowing that the か column (ka, ki, ku, ke, ko) corresponds to verb stem changes helps learners predict conjugations instead of memorizing each form separately.

## Scope

- **Interactive Gojuon Table**: Traditional right-to-left layout matching authentic Japanese teaching materials
- **Learn Mode**: Explore characters with visual highlighting of columns (verb stems) and rows (conjugation endings)
- **Practice Mode**: Quiz exercises focused on column and row pattern recognition
- **Dual Script Support**: Switch between Hiragana (ひらがな) and Katakana (カタカナ)
- **Audio Pronunciation**: Native pronunciation for each character
- **Stroke Order Animations**: Visual guides for correct character writing

## Challenge

Most Japanese learning apps treat the Gojuon as a simple character memorization exercise. This approach misses the deeper grammatical significance of the chart's structure:

- **Column Learning (行)**: Each column represents consonant sounds and verb stem patterns. Understanding that 書く (kaku - to write) follows the か column helps predict all its conjugations.
- **Row Learning (段)**: Each row represents vowel sounds and conjugation endings. The え row endings often indicate potential or conditional forms.

Learners who memorize characters without understanding this structure struggle to make the leap to grammar comprehension.

## Solution

We built Gojuon Master as a modern React application with a focus on structural learning:

**Traditional Layout**
The app presents the Gojuon in its authentic right-to-left, top-to-bottom format. This matters because Japanese teaching materials use this layout, and understanding column/row relationships requires seeing the chart as Japanese learners traditionally do.

**Interactive Learning**
Click any column header to highlight all characters in that column—immediately visualizing verb stem patterns. Click any row label to highlight conjugation ending patterns. This interactivity transforms passive memorization into active structural understanding.

**Practice with Purpose**
Practice mode offers column-focused and row-focused exercises. Instead of random character quizzes, learners can specifically practice the か column to reinforce verb stem patterns or the う row to understand dictionary form endings.

**Technical Excellence**
Built with React 18 and Vite for optimal performance. Comprehensive test coverage ensures reliability. CI/CD pipeline with GitHub Actions automates testing, linting, and deployment. Hosted on Netlify for fast global delivery.

## Results

Gojuon Master launched as a free educational resource available at gojuonmaster.com. The project demonstrates our approach to building software:

- **Solve a real problem**: Address the gap between character memorization and grammar understanding
- **Respect the domain**: Use traditional Japanese layouts and educational approaches
- **Build with quality**: Comprehensive testing, accessibility, and clean code
- **Share freely**: Open source contribution to the Japanese learning community

The project continues to evolve with a roadmap including spaced repetition, advanced verb conjugation exercises, and offline PWA support.