Skip to content

princessnvidia/Hanzi-App

Repository files navigation

Hanzi App 🇨🇳

Modern Mandarin learning application built around active recall, contextual reading and progressive vocabulary acquisition.

Hanzi App helps learners move naturally from their first Chinese characters to reading complete stories through a clean, distraction-free interface.


Hanzi App Demo


Features

  • 📖 Vocabulary from beginner to advanced
  • ✍ Character writing practice
  • 📚 Reading mode with graded texts
  • 🎯 Active recall quizzes
  • 📊 Learning statistics
  • 🌙 Clean dark interface
  • 📱 Android support via Capacitor
  • ⚡ Instant feedback

Tech Stack

  • React
  • Vite
  • JavaScript
  • CSS
  • Capacitor
  • Android

Learning Pipeline

Vocabulary
      │
      ▼
Recognition
      │
      ▼
Writing Practice
      │
      ▼
Reading Practice
      │
      ▼
Statistics
      │
      ▼
Long-term Memorization

Current Content

Vocabulary

  • ✅ Beginner
  • ✅ Intermediate
  • ✅ Advanced

Reading

  • ✅ Chinese Breeze inspired stories
  • 🚧 More graded readers coming soon

Statistics

  • Success rate
  • Vocabulary mastery
  • Writing accuracy
  • Reading progression

Roadmap

Learning

  • Stroke order animations
  • Character decomposition
  • Audio pronunciation
  • Grammar lessons
  • Daily challenges

Application

  • Offline mode
  • Cloud synchronization
  • Better Android experience
  • Multiple learning profiles

Installation

Clone the repository

git clone https://github.com/princessnvidia/hanzi-app.git
cd hanzi-app

Install dependencies

npm install

Start development

npm run dev

Build

Web

npm run build

Android

npx cap sync
npx cap open android

Philosophy

Learning Chinese should feel like discovering a language, not completing flashcards.

Hanzi App combines active recall, contextual reading and progressive repetition to help learners naturally recognize, remember and understand Chinese characters over time.

The long-term goal is to provide a complete learning journey—from first words to reading entire stories—while keeping the experience simple, visual and enjoyable.


Status

🚧 Active Development


License

MIT License

About

Mandarin learning application focused on active recall, vocabulary progression and handwriting practice.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors