PKC Korean Learning App - Development Status Report

📚 PKC Korean Learning App - Development Status Report

Date: November 24, 2025

Project: PKC Korean Learning App

Status: In Development

Project Overview

The PKC Korean Learning App is a web-based multilingual platform designed to help learners worldwide study Korean in their native language.

We have currently completed the implementation of core features and are in the process of constructing data to support 11 different languages.

Tech Stack & Architecture

Technologies Used

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Data: Structured Language Packs (JSON based)
• Key Features: Web Speech API (TTS), LocalStorage (User preferences)

 

Directory Structure

We maximized scalability by completely separating the logic (js) from the data (locales).

Root/
├── index.html          # Main Entry Point
├── css/                # Stylesheets
├── js/                 # Core Logic
│   ├── app.js          # App Initialization
│   ├── i18n.js         # Multilingual Processing Engine
│   ├── hangul-learning.js # Hangul Learning Module
│   ├── vocabulary.js   # Vocabulary Learning Module
│   ├── grammar.js      # Grammar Learning Module
│   └── flashcard.js    # Flashcard Module
├── data/               # Base Korean Data
└── locales/            # Multilingual Language Packs
    ├── en/             # English
    ├── ja/             # Japanese
    └── ...             # Total of 11 Languages

Core Features Implementation

Proprietary I18n Engine

Our custom-built internationalization engine features the following:

• Dynamic Loading: Asynchronously loads only the relevant language pack when the language is changed, optimizing performance.
• Path Management: Automatically recognizes the locales/{lang}/{lang}_{type}.json pattern.
• Fallback System: Automatically reverts to Korean data if a specific file is missing.

Data Normalization

We unified the unique keys of each language file (e.g., English, Japanese) into an internal meaning property. This allows all language data to be displayed without modifying the UI code.

Learning Modules

• Learn Hangul: Organized by tabs for Consonants, Vowels, and Batchim (final consonants) with language-specific explanations.
• Vocabulary: Categorized filtering and TTS pronunciation support.
• Flashcards: Card flipping interaction and learning progress saving.
• Grammar: Explanations of the SOV word order and grammar systems.

Multilingual Support Status

Supported Languages (11 Countries)

English, Japanese, Chinese, Russian, Thai, German, Spanish, French, Italian, Portuguese, Dutch

Progress Status

• ✅ Data Structure Design: Completed
• ✅ Basic Word Translation Data: Generated (_words.json for 10 languages)
• 🔄 UI & Explanation Data: JSON file generation and directory structuring in progress

Future Roadmap

1. UI Integration Testing: Final check of actual integration with generated language packs.
2. Grammar Explanation Refinement: Enhancing grammar explanations tailored to specific language groups.
3. Responsive Design: Strengthening layouts to accommodate longer text (e.g., German, Russian).

Conclusion

The PKC Korean Learning App is being developed as a scalable platform based on a flexible architecture that separates data from logic. It allows for immediate service in a new language simply by adding a language pack file.

Stay tuned for a future where learners around the world can easily master Korean in their own native language!